Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes