CKTIS / JavaScript
EventTarget — sprejemanje in proženje dogodkov
EventTarget je vmesnik Web API za registracijo poslušalcev in proženje dogodkov. Samostojen primerek je mogoče ustvariti brez elementa DOM.
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
const target = new EventTarget();
target.addEventListener(type, callback, options);
target.removeEventListener(type, callback, options);
const notCanceled = target.dispatchEvent(event);EventTarget je vmesnik Web API, ne pa del standarda ECMAScript. new EventTarget() ustvari samostojen cilj dogodkov brez nadrejenega elementa v drevesu širjenja.
addEventListener() registrira poslušalca. removeEventListener() zahteva isto vrsto dogodka, isti sklic na povratni klic in ujemajočo se vrednost capture. Pri možnosti once: true se registracija poslušalca samodejno odstrani, še preden se izvede povratni klic. Če ta klic na istem cilju sproži nov dogodek iste vrste, odstranjena registracija ne povzroči ponovnega klica.
dispatchEvent() poslušalce pokliče sinhrono. Vrne false, če je zastavica za preklic dogodka nastavljena, sicer vrne true. Pri preklicljivem dogodku je mogoče to zastavico nastaviti s klicem preventDefault() ali s prireditvijo event.returnValue = false, ki je ohranjena zaradi združljivosti. Rezultat ne pove, ali poslušalec obstaja. Primer zahteva okolje, ki zagotavlja EventTarget in Event, ne potrebuje pa brskalnika. V okolju Node.js 24 deluje brez sprememb, kar ne dokazuje združljivosti z brskalniki.
Primeri
const target = new EventTarget();
const log = [];
function onPing(event) {
log.push(event.type);
event.preventDefault();
}
target.addEventListener('ping', onPing, { once: true });
const first = target.dispatchEvent(new Event('ping', { cancelable: true }));
const second = target.dispatchEvent(new Event('ping', { cancelable: true }));
console.log(log.join(','));
console.log(first);
console.log(second);Rezultat
ping false true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.