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.