CustomEvent: CustomEvent() Konstruktor
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Der CustomEvent() Konstruktor erstellt ein neues CustomEvent Objekt.
Syntax
new CustomEvent(type)
new CustomEvent(type, options)
Parameter
type-
Ein String, der den Namen des Ereignisses angibt. Ereignisnamen sind case-sensitiv.
optionsOptional-
Ein Objekt, das zusätzlich zu den in
Event()definierten Eigenschaften die folgenden Eigenschaften haben kann:detailOptional-
Ein ereignisabhängiger Wert, der mit dem Ereignis verknüpft ist. Dieser Wert steht dann dem Handler über die
CustomEvent.detailEigenschaft zur Verfügung. Der Standardwert istnull.
Rückgabewert
Ein neues CustomEvent Objekt.
Beispiel
// create custom events
const catFound = new CustomEvent("animalfound", {
detail: {
name: "cat",
},
});
const dogFound = new CustomEvent("animalfound", {
detail: {
name: "dog",
},
});
const element = document.createElement("div"); // create a <div> element
// add an appropriate event listener
element.addEventListener("animalfound", (e) => console.log(e.detail.name));
// dispatch the events
element.dispatchEvent(catFound);
element.dispatchEvent(dogFound);
// "cat" and "dog" logged in the console
Zusätzliche Beispiele finden Sie unter Erstellen und Auslösen von Ereignissen.
Spezifikationen
| Spezifikation |
|---|
| DOM # ref-for-dom-customevent-customevent |