Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje