CKTIS / JavaScript
EventTarget.dispatchEvent(): sinkrono slanje događaja
dispatchEvent(event) sinkrono šalje događaj cilju. Booleov rezultat pokazuje je li događaj otkazan, a ne postoje li slušatelji.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
target.dispatchEvent(event)target.dispatchEvent(event) šalje objekt Event u EventTarget. Slušatelji se pozivaju sinkrono; metoda ne čeka dovršetak asinkronog posla koji slušatelji pokrenu. Događaj ima isTrusted === false.
Rezultat je false ako je događaj otkazan, a u suprotnom true. preventDefault() otkazuje događaj samo uz cancelable: true i izvan pasivnog slušatelja. stopPropagation() ne znači da je događaj otkazan.
U DOM stablu primjenjuju se faza hvatanja i neobavezno bubbling ponašanje (bubbles). Samostalni new EventTarget() nema roditelja. Iznimke slušatelja prijavljuju se, ali se ne propagiraju do pozivatelja. Ponovno slanje objekta koji se trenutačno šalje uzrokuje InvalidStateError.
Primjer prikazuje sinkroni redoslijed i otkazivanje. Aplikacijski kod može upotrijebiti rezultat kako bi preskočio spremanje.
Primjeri
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(" | "));Rezultat
before | listener | after: false
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.