CKTIS / JavaScript
EventTarget — ricevere e inviare eventi
EventTarget è un’interfaccia della Web API che consente di registrare listener e inviare eventi. È possibile creare un’istanza autonoma senza un elemento DOM.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
const target = new EventTarget();
target.addEventListener(type, callback, options);
target.removeEventListener(type, callback, options);
const notCanceled = target.dispatchEvent(event);EventTarget è un’interfaccia della Web API, non fa parte dello standard ECMAScript. new EventTarget() crea un target di eventi autonomo, senza un genitore nell’albero di propagazione.
addEventListener() registra un listener. removeEventListener() richiede lo stesso tipo di evento, lo stesso riferimento alla callback e un valore capture corrispondente. Con once: true, la registrazione del listener viene rimossa automaticamente prima che la callback venga invocata. Se la callback invia un nuovo evento dello stesso tipo sullo stesso target, la registrazione rimossa non provoca una nuova invocazione.
dispatchEvent() invoca i listener in modo sincrono. Restituisce false se il flag di annullamento dell’evento è impostato; altrimenti restituisce true. Per un evento annullabile, il flag può essere impostato sia da una chiamata a preventDefault() sia dall’assegnazione event.returnValue = false, mantenuta per compatibilità. Il risultato non indica se esiste un listener. L’esempio richiede un ambiente che metta a disposizione EventTarget e Event, ma non richiede un browser. Funziona senza modifiche in Node.js 24, il che non dimostra la compatibilità con i browser.
Esempi
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);Risultato
ping false true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.