WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

CustomEvent — Ereignisse mit eigenen Daten

CustomEvent erweitert Event um detail und ermöglicht so, dass anwendungsspezifische Daten die Listener eines Ereignisses erreichen.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

new CustomEvent(type, { detail: null, bubbles: false, cancelable: false, composed: false })

CustomEvent ist eine Web-API-Schnittstelle aus dem DOM Standard, nicht aus ECMAScript. Der Konstruktor nimmt einen Ereignisnamen und optionale Einstellungen entgegen. Über die Option detail lässt sich jeder JavaScript-Wert außer undefined übergeben. Wenn du die Option weglässt oder ausdrücklich undefined übergibst, verwendet Web IDL den Standardwert null. Objekte werden nicht kopiert.

Ein Ereignis zu erstellen, sendet es nicht: Rufe dispatchEvent() auf einem EventTarget auf. Listener werden mit addEventListener() registriert. Das Auslösen erfolgt synchron. Die Optionen bubbles, cancelable und composed sind standardmäßig false. Prüfe die Verfügbarkeit der API im Zielbrowser; die Node-Version des Repositorys bestätigt sie nicht.

Beispiele

{
  const target = new EventTarget();
  target.addEventListener("score", (event) => {
    console.log(`score=${event.detail}`);
  });
  target.dispatchEvent(new CustomEvent("score", { detail: 7 }));
  console.log("done");
}

Ergebnis

score=7
done

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen