Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti