CKTIS / JavaScript
CustomEvent.detail — dane własnego zdarzenia
CustomEvent.detail udostępnia dane przekazane podczas tworzenia zdarzenia. Domyślnie ma wartość null; obiekty są przekazywane bez klonowania.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const event = new CustomEvent(type, { detail: value });
event.detailCustomEvent.detail to właściwość instancji CustomEvent zawierająca dane ustawione przez opcję detail konstruktora. Jeśli opcję detail pominięto lub jawnie ustawiono na undefined, Web IDL stosuje wartość domyślną null, więc event.detail === null.
Właściwość jest tylko do odczytu, ale nie zamraża przechowywanego obiektu. Obiekt nie jest klonowany: modyfikacja event.detail.count zmienia ten sam obiekt, który przekazano konstruktorowi.
Odbiorca odczytuje dane przez event.detail. Przykład pokazuje wspólną referencję i domyślne null. To interfejs DOM, nie funkcja samego ECMAScript; obecność Node 24 w repozytorium nie potwierdza obsługi w przeglądarce.
Przykłady
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);Wynik
true 2 null
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.