Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

CustomEvent — zdarzenia z własnymi danymi

CustomEvent rozszerza Event o detail, umożliwiając przekazywanie własnych danych odbiorcom zdarzenia.

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

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

CustomEvent to interfejs Web API z DOM Standard, nie element ECMAScript. Konstruktor przyjmuje nazwę zdarzenia i opcjonalne ustawienia. Opcja detail może przenosić dowolną wartość JavaScript z wyjątkiem undefined. Jeśli pominiesz tę opcję lub jawnie przekażesz undefined, zgodnie z regułami Web IDL zostanie użyta wartość domyślna null. Obiekty nie są kopiowane.

Samo utworzenie zdarzenia go nie wysyła: użyj dispatchEvent() na EventTarget. Odbiorców rejestruje addEventListener(). Obsługa jest synchroniczna. Opcje bubbles, cancelable i composed domyślnie wynoszą false. Dostępność API sprawdzaj w docelowej przeglądarce; wersja Node w repozytorium jej nie potwierdza.

Przykłady

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

Wynik

score=7
done

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła