CKTIS / JavaScript
Event.stopPropagation() — interrompere la propagazione di un evento
stopPropagation() interrompe l’ulteriore propagazione dell’evento, ma non annulla l’azione predefinita né gli altri listener nell’invocazione corrente.
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
event.stopPropagation()event.stopPropagation() è un metodo della DOM Web API, non una funzione ECMAScript. Restituisce undefined. Interrompe l’ulteriore propagazione sia durante la fase di cattura sia durante il bubbling; non annulla i listener già eseguiti. Se viene chiamato su un antenato durante la cattura, può impedire all’evento di raggiungere il suo obiettivo.
Non interrompe il callback corrente né gli altri listener nell’invocazione corrente sullo stesso oggetto. stopImmediatePropagation() interrompe anche questi altri listener. preventDefault() ha uno scopo diverso: annulla l’azione predefinita quando l’evento e le condizioni dell’invocazione lo consentono.
Nell’esempio, la cattura su parent avviene per prima. Il primo listener di child blocca il bubbling verso parent, ma il secondo viene comunque eseguito. defaultPrevented rimane false. Esegui il codice in un browser; la presenza di Node 24 non dimostra il supporto per il DOM del browser.
Esempi
const parent = document.createElement('div');
const child = document.createElement('button');
parent.append(child);
const log = [];
parent.addEventListener('demo', () => log.push('parent capture'), true);
parent.addEventListener('demo', () => log.push('parent bubble'));
child.addEventListener('demo', (event) => {
log.push('child first');
event.stopPropagation();
});
child.addEventListener('demo', () => log.push('child second'));
const event = new Event('demo', { bubbles: true, cancelable: true });
child.dispatchEvent(event);
log.push(`defaultPrevented: ${event.defaultPrevented}`);
console.log(log.join('\n'));Risultato
parent capture child first child second defaultPrevented: false
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.