CKTIS / JavaScript
Event.stopPropagation() — parar a propagação de um evento
stopPropagation() para a propagação seguinte do evento, mas não cancela a ação predefinida nem os restantes listeners na invocação atual.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
event.stopPropagation()event.stopPropagation() é um método da DOM Web API, não uma função ECMAScript. Devolve undefined. Para a propagação seguinte tanto durante a captura como durante o bubbling; não desfaz os listeners que já foram executados. Se for chamada num antepassado durante a captura, pode impedir que o evento chegue ao seu destino.
Não interrompe o callback atual nem os restantes listeners na invocação atual sobre o mesmo objeto. stopImmediatePropagation() também para esses outros listeners. preventDefault() tem uma função diferente: cancela a ação predefinida quando o evento e as condições da invocação o permitem.
No exemplo, a captura em parent acontece primeiro. O primeiro listener de child bloqueia o bubbling para parent, mas o segundo é executado na mesma. defaultPrevented continua a ser false. Executa o código num browser; a presença de Node 24 não comprova o suporte do DOM do browser.
Exemplos
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'));Resultado
parent capture child first child second defaultPrevented: false
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.