Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

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

Źródła