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

CKTIS / JavaScript

Event.bubbles — propagación de eventos

Event.bubbles es una propiedad booleana de solo lectura que indica si un evento puede propagarse desde su objetivo hasta sus antecesores. El valor false no desactiva la captura ni el tratamiento en el propio objetivo.

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.bubbles
new Event(type, { bubbles: true })

Event.bubbles devuelve el valor booleano establecido al inicializar el evento. En new Event(type, options), la opción bubbles tiene el valor predeterminado false; establecer { bubbles: true } activa la propagación ascendente.

La propagación ascendente va desde el objetivo hacia sus antecesores. false no impide la fase de captura ni la invocación de los controladores en el objetivo. El ejemplo muestra ambas configuraciones en un árbol DOM desconectado.

bubbles no indica si la propagación llegó realmente a un antecesor: stopPropagation() puede detenerla sin cambiar esta propiedad. cancelable se refiere a la cancelación mediante preventDefault(), mientras que composed se refiere al cruce de los límites del Shadow DOM; son ajustes distintos.

Esta API pertenece al estándar DOM, no a ECMAScript en sí. El ejemplo requiere un DOM de navegador; que Node 24 esté presente en un repositorio no demuestra que sea compatible con este entorno ni con las API del navegador.

Ejemplos

{
  const parent = document.createElement('div');
  const child = document.createElement('div');
  parent.appendChild(child);
  const log = [];

  parent.addEventListener('demo', (event) => {
    log.push(`capture: ${event.bubbles}`);
  }, { capture: true });
  child.addEventListener('demo', (event) => {
    log.push(`target: ${event.bubbles}`);
  });
  parent.addEventListener('demo', (event) => {
    log.push(`bubble: ${event.bubbles}`);
  });

  child.dispatchEvent(new Event('demo'));
  child.dispatchEvent(new Event('demo', { bubbles: true }));
  console.log(log.join('\n'));
}

Resultado

capture: false
target: false
capture: true
target: true
bubble: true

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