Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Event.bubbles — propagazione degli eventi

Event.bubbles è una proprietà booleana di sola lettura che indica se un evento può propagarsi dal suo target ai suoi antenati. Il valore false non disattiva la fase di cattura né la gestione dell’evento sul target stesso.

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

Sintassi

event.bubbles
new Event(type, { bubbles: true })

Event.bubbles restituisce il valore booleano stabilito quando l’evento viene inizializzato. In new Event(type, options), l’opzione bubbles è false per impostazione predefinita; impostando { bubbles: true } si attiva la propagazione.

La propagazione procede dal target verso i suoi antenati. false non impedisce la fase di cattura né l’invocazione dei listener sul target. L’esempio mostra entrambe le configurazioni su un albero DOM scollegato.

bubbles non indica se la propagazione abbia effettivamente raggiunto un antenato: stopPropagation() può interromperla senza modificare questa proprietà. cancelable riguarda l’annullamento tramite preventDefault(), mentre composed riguarda il superamento dei confini dello Shadow DOM; sono impostazioni distinte.

Questa API appartiene allo standard DOM, non a ECMAScript in sé. L’esempio richiede un DOM del browser; la presenza di Node 24 in un repository non dimostra il supporto per questo ambiente o per le API del browser.

Esempi

{
  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'));
}

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti