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.detailCustomEvent.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.