Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje