CKTIS / JavaScript
EventTarget.dispatchEvent(): synchronní odeslání události
dispatchEvent(event) synchronně odešle událost cíli. Booleovský výsledek udává, zda byla událost zrušena, nikoli zda existují posluchače.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
target.dispatchEvent(event)target.dispatchEvent(event) odešle objekt Event do EventTarget. Posluchače se volají synchronně; metoda nečeká na dokončení asynchronní práce, kterou posluchače spustí. Událost má isTrusted === false.
Výsledek je false, pokud byla událost zrušena, jinak je true. preventDefault() zruší událost pouze při cancelable: true a mimo pasivního posluchače. stopPropagation() neznamená zrušení události.
Ve stromu DOM platí fáze zachycení a případné probublávání (bubbles). Samostatný new EventTarget() nemá rodiče. Výjimky posluchačů se hlásí, ale nepropagují se k volajícímu. Opětovné odeslání objektu, který se právě odesílá, způsobí InvalidStateError.
Příklad ukazuje synchronní pořadí a zrušení. Kód aplikace může výsledek využít k přeskočení ukládání.
Pří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ýsledek
before | listener | after: false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.