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.