Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Event.bubbles — propagation par bouillonnement

Event.bubbles est une propriété booléenne en lecture seule qui indique si un événement peut remonter de sa cible vers ses ancêtres. La valeur false ne désactive ni la capture ni le traitement de l’événement sur la cible elle-même.

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

Syntaxe

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

Event.bubbles renvoie la valeur booléenne définie lors de l’initialisation de l’événement. Dans new Event(type, options), l’option bubbles vaut false par défaut ; définir { bubbles: true } active le bouillonnement.

Le bouillonnement se propage de la cible vers ses ancêtres. false n’empêche ni la phase de capture ni l’appel des écouteurs sur la cible. L’exemple présente les deux configurations sur un arbre DOM détaché.

bubbles n’indique pas si la propagation a effectivement atteint un ancêtre : stopPropagation() peut l’interrompre sans modifier cette propriété. cancelable concerne l’annulation avec preventDefault(), tandis que composed concerne le franchissement des limites du Shadow DOM ; ce sont des paramètres distincts.

Cette API relève du standard DOM, et non d’ECMAScript lui-même. L’exemple nécessite un DOM de navigateur ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge de cet environnement ou des API de navigateur.

Exemples

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

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources