CKTIS / JavaScript
EventTarget — prijímanie a vyvolávanie udalostí
EventTarget je rozhranie Web API na registráciu poslucháčov a vyvolávanie udalostí. Samostatnú inštanciu možno vytvoriť bez prvku DOM.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const target = new EventTarget();
target.addEventListener(type, callback, options);
target.removeEventListener(type, callback, options);
const notCanceled = target.dispatchEvent(event);EventTarget je rozhranie Web API, nie súčasť štandardu ECMAScript. new EventTarget() vytvorí samostatný cieľ udalostí bez rodiča v strome šírenia.
addEventListener() zaregistruje poslucháča. removeEventListener() vyžaduje rovnaký typ udalosti, rovnakú referenciu na callback a zhodnú hodnotu capture. Pri voľbe once: true sa registrácia poslucháča automaticky odstráni ešte pred zavolaním jeho callbacku. Ak callback vyvolá novú udalosť rovnakého typu na rovnakom cieli, odstránená registrácia už nespôsobí jeho opätovné zavolanie.
dispatchEvent() vyvoláva poslucháčov synchrónne. Vráti false, ak je nastavený príznak zrušenia udalosti; inak vráti true. Pri zrušiteľnej udalosti možno tento príznak nastaviť volaním preventDefault() alebo priradením event.returnValue = false, ktoré je zachované kvôli kompatibilite. Výsledok nehovorí, či poslucháč existuje. Príklad vyžaduje prostredie, ktoré poskytuje EventTarget a Event, ale prehliadač nie je potrebný. V Node.js 24 funguje bez úprav, čo nedokazuje kompatibilitu s prehliadačmi.
Príklady
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);Výsledok
ping false true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.