Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Event.stopPropagation() — detener la propagación de eventos

stopPropagation() detiene la propagación posterior del evento, pero no cancela la acción predeterminada ni los demás listeners de la invocación actual.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

event.stopPropagation()

event.stopPropagation() es un método de la DOM Web API, no una función de ECMAScript. Devuelve undefined. Detiene la propagación posterior tanto durante la captura como durante el burbujeo; no deshace los listeners que ya se hayan ejecutado. Si se llama en un ancestro durante la captura, puede impedir que el evento llegue a su destino.

No interrumpe el callback actual ni los demás listeners de la invocación actual en el mismo objeto. stopImmediatePropagation() también detiene esos otros listeners. preventDefault() tiene otra función: cancela la acción predeterminada cuando el evento y las condiciones de la invocación lo permiten.

En el ejemplo, primero ocurre la captura en parent. El primer listener de child bloquea el burbujeo hacia parent, pero el segundo se ejecuta igualmente. defaultPrevented sigue siendo false. Ejecuta el código en un navegador; la presencia de Node 24 no demuestra que sea compatible con el DOM del navegador.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes