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

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.

Fontes