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.