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.