CKTIS / JavaScript
CustomEvent — udalosti s vlastnými údajmi
CustomEvent rozširuje Event o detail, vďaka čomu sa údaje definované aplikáciou dostanú k poslucháčom udalosti.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new CustomEvent(type, { detail: null, bubbles: false, cancelable: false, composed: false })CustomEvent je rozhranie Web API zo štandardu DOM Standard, nie súčasť ECMAScriptu. Jeho konštruktor prijíma názov udalosti a voliteľné nastavenia. Pomocou voľby detail možno odovzdať ľubovoľnú hodnotu JavaScriptu okrem undefined. Ak túto voľbu vynecháte alebo explicitne odovzdáte undefined, podľa pravidiel Web IDL sa použije predvolená hodnota null. Objekty sa nekopírujú.
Vytvorením udalosti sa udalosť neodošle: zavolajte dispatchEvent() na objekte EventTarget. Poslucháčov registrujte pomocou addEventListener(). Odoslanie je synchrónne. Možnosti bubbles, cancelable a composed majú predvolene hodnotu false. Dostupnosť API overte v cieľovom prehliadači; verzia Node v repozitári ju nepotvrdzuje.
Príklady
{
const target = new EventTarget();
target.addEventListener("score", (event) => {
console.log(`score=${event.detail}`);
});
target.dispatchEvent(new CustomEvent("score", { detail: 7 }));
console.log("done");
}Výsledok
score=7 done
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.