WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

CustomEvent.detail — Daten benutzerdefinierter Ereignisse

CustomEvent.detail stellt Daten bereit, die beim Erstellen eines Ereignisses übergeben wurden. Der Standardwert ist null; Objekte werden ohne Klonen übergeben.

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

const event = new CustomEvent(type, { detail: value });
event.detail

CustomEvent.detail ist eine Instanzeigenschaft von CustomEvent, die Daten enthält, die über die detail-Option des Konstruktors festgelegt wurden. Wird detail weggelassen oder ausdrücklich auf undefined gesetzt, verwendet Web IDL den Standardwert null, sodass event.detail === null gilt.

Die Eigenschaft ist schreibgeschützt, friert das gespeicherte Objekt aber nicht ein. Das Objekt wird nicht geklont: Eine Änderung an event.detail.count verändert dasselbe Objekt, das dem Konstruktor übergeben wurde.

Ein Listener liest die Daten über event.detail. Das Beispiel veranschaulicht die gemeinsame Referenz und den Standardwert null. Dies ist eine DOM-Schnittstelle und kein Feature der ECMAScript-Sprache; Node 24 in einem Repository belegt keine Browserunterstützung.

Beispiele

const target = new EventTarget();
const payload = { count: 1 };

 target.addEventListener("count-change", (event) => {
  console.log(event.detail === payload);
  event.detail.count += 1;
});

target.dispatchEvent(new CustomEvent("count-change", { detail: payload }));
console.log(payload.count);
console.log(new CustomEvent("empty").detail);

Ergebnis

true
2
null

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