CKTIS / JavaScript
EventTarget — primanje i slanje događaja
EventTarget je sučelje Web API-ja za registriranje slušatelja i slanje događaja. Samostalna instanca može se stvoriti bez DOM elementa.
Verzija: 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 sučelje Web API-ja, a ne dio standarda ECMAScript. new EventTarget() stvara samostalni cilj događaja bez roditelja u stablu propagacije.
addEventListener() registrira slušatelja. removeEventListener() zahtijeva istu vrstu događaja, istu referencu povratnog poziva i podudarnu vrijednost capture. Uz mogućnost once: true registracija slušatelja automatski se uklanja prije izvršavanja povratnog poziva. Ako povratni poziv pošalje novi događaj iste vrste na istom cilju, uklonjena registracija neće dovesti do ponovnog poziva.
dispatchEvent() poziva slušatelje sinkrono. Vraća false ako je postavljena zastavica otkazivanja događaja; u suprotnom vraća true. Za događaj koji se može otkazati ta se zastavica može postaviti pozivom metode preventDefault() ili dodjelom event.returnValue = false, koja je zadržana radi kompatibilnosti. Rezultat ne pokazuje postoji li slušatelj. Primjer zahtijeva okruženje koje pruža EventTarget i Event, ali ne zahtijeva preglednik. Radi bez izmjena u okruženju Node.js 24, što ne dokazuje kompatibilnost s preglednicima.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.