CKTIS / JavaScript
Event.bubbles — propagação de eventos
Event.bubbles é uma propriedade booleana só de leitura que indica se um evento pode propagar-se do seu alvo para os antecessores. O valor false não desativa a captura nem o tratamento do evento no próprio alvo.
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.bubbles
new Event(type, { bubbles: true })Event.bubbles devolve o valor booleano definido quando o evento é inicializado. Em new Event(type, options), a opção bubbles tem o valor predefinido false; definir { bubbles: true } ativa a propagação.
A propagação ocorre do alvo para os seus antecessores. false não impede a fase de captura nem a invocação de ouvintes no alvo. O exemplo demonstra ambas as configurações numa árvore DOM desligada do documento.
bubbles não indica se a propagação chegou efetivamente a um antecessor: stopPropagation() pode interrompê-la sem alterar esta propriedade. cancelable diz respeito ao cancelamento através de preventDefault(), enquanto composed diz respeito à passagem pelos limites do Shadow DOM; são definições distintas.
Esta API pertence à norma DOM, não ao próprio ECMAScript. O exemplo requer um DOM de navegador; a presença de Node 24 num repositório não comprova o suporte para este ambiente ou para APIs de navegador.
Exemplos
{
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
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.