CKTIS / JavaScript
EventTarget.dispatchEvent(): synchrónne odoslanie udalosti
dispatchEvent(event) synchrónne odošle udalosť cieľu. Booleovský výsledok vyjadruje, či bola udalosť zrušená, nie to, či existujú poslucháči.
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
target.dispatchEvent(event)target.dispatchEvent(event) odošle objekt Event do EventTarget. Poslucháči sa volajú synchrónne; metóda nečaká na dokončenie asynchrónnej práce, ktorú poslucháči spustia. Udalosť má isTrusted === false.
Výsledok je false, ak bola udalosť zrušená, inak je true. preventDefault() zruší udalosť iba pri cancelable: true a mimo pasívneho poslucháča. stopPropagation() neznamená zrušenie udalosti.
V strome DOM platí fáza zachytávania a prípadné prebublávanie (bubbles). Samostatný new EventTarget() nemá rodiča. Výnimky poslucháčov sa hlásia, ale nepropagujú sa k volajúcemu. Opätovné odoslanie objektu, ktorý sa práve odosiela, spôsobí InvalidStateError.
Príklad ukazuje synchrónne poradie a zrušenie. Kód aplikácie môže výsledok využiť na vynechanie ukladania.
Príklady
const target = new EventTarget();
const log = [];
target.addEventListener("save", (event) => {
log.push("listener");
event.preventDefault();
});
log.push("before");
const accepted = target.dispatchEvent(
new Event("save", { cancelable: true })
);
log.push(`after: ${accepted}`);
console.log(log.join(" | "));Výsledok
before | listener | after: false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.