Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

EventTarget.dispatchEvent(): sinhrono odpošiljanje dogodkov

dispatchEvent(event) sinhrono odpošlje dogodek cilju. Logična vrednost rezultata pove, ali je bil dogodek preklican, ne pa tega, ali obstajajo poslušalci.

Različica: 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) odpošlje objekt Event v EventTarget. Poslušalci se pokličejo sinhrono; metoda ne čaka na dokončanje asinhronega dela, ki ga začnejo poslušalci. Dogodek ima isTrusted === false.

Rezultat je false, če je dogodek preklican, sicer pa true. preventDefault() prekliče dogodek samo pri cancelable: true in zunaj pasivnega poslušalca. stopPropagation() ne pomeni preklica dogodka.

V drevesu DOM veljata faza zajemanja in neobvezno širjenje navzgor (bubbles). Samostojni new EventTarget() nima nadrejenega elementa. Izjeme poslušalcev se sporočijo, vendar se ne razširijo do klicatelja. Ponovno odpošiljanje objekta, ki se trenutno odpošilja, povzroči InvalidStateError.

Primer prikazuje sinhroni vrstni red in preklic. Koda aplikacije lahko rezultat uporabi za izpust shranjevanja.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri