CKTIS / JavaScript
EventTarget.addEventListener — registrare listener di eventi
EventTarget.addEventListener registra una funzione callback per un evento. Le opzioni capture, once e passive controllano l’invocazione e la possibilità per il listener di annullare l’evento.
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
target.addEventListener(type, callback, options);
// options: boolean capture, or { capture, once, passive, signal }EventTarget.addEventListener registra un callback per il tipo di evento type. Il terzo argomento è un oggetto di opzioni o un valore booleano che rappresenta capture. Questa API fa parte dello standard DOM, non di ECMAScript in sé.
capture: true seleziona la fase di cattura invece del bubbling sugli antenati; entrambe le impostazioni consentono l’invocazione sul target stesso. Sia capture sia once hanno valore predefinito false. Con once: true, la registrazione viene rimossa prima che venga invocato callback. Se callback invia un evento durante l’invocazione, l’invio annidato non può invocare di nuovo callback tramite la stessa registrazione. passive: true impedisce l’annullamento tramite preventDefault(), ma non arresta la propagazione. Per annullare un evento annullabile, imposta esplicitamente passive: false: omettere l’opzione non significa sempre false.
I duplicati vengono identificati da type, dall’identità di callback e da capture; una nuova registrazione non aggiorna le opzioni. removeEventListener richiede gli stessi tre valori. L’esempio usa un target indipendente, quindi non mostra la propagazione tra elementi.
Esempi
const target = new EventTarget();
let calls = 0;
target.addEventListener('demo', (event) => {
calls++;
event.preventDefault();
}, { capture: false, once: true, passive: false });
const first = new Event('demo', { cancelable: true });
target.dispatchEvent(first);
target.dispatchEvent(new Event('demo'));
console.log(calls, first.defaultPrevented);Risultato
1 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.