CKTIS / JavaScript
Event.bubbles — Ereignisblasen
Event.bubbles ist eine schreibgeschützte Boolean-Eigenschaft, die angibt, ob ein Ereignis von seinem Ziel zu dessen Vorfahren aufsteigen kann. Der Wert false deaktiviert weder die Capture-Phase noch die Verarbeitung direkt am Ziel.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.bubbles
new Event(type, { bubbles: true })Event.bubbles gibt den Boolean-Wert zurück, der bei der Initialisierung des Ereignisses festgelegt wurde. Bei new Event(type, options) ist die Option bubbles standardmäßig false; mit { bubbles: true } wird das Bubbling aktiviert.
Beim Bubbling bewegt sich das Ereignis vom Ziel zu dessen Vorfahren. false verhindert weder die Capture-Phase noch das Aufrufen von Listenern am Ziel. Das Beispiel zeigt beide Konfigurationen an einem nicht in das Dokument eingefügten DOM-Baum.
bubbles gibt nicht an, ob die Propagation tatsächlich einen Vorfahren erreicht hat: stopPropagation() kann sie anhalten, ohne diese Eigenschaft zu ändern. cancelable betrifft das Abbrechen mit preventDefault(), während composed das Überschreiten von Shadow-DOM-Grenzen betrifft; es handelt sich um getrennte Einstellungen.
Diese API gehört zum DOM-Standard, nicht zu ECMAScript selbst. Das Beispiel benötigt ein Browser-DOM; dass Node 24 im Repository vorhanden ist, belegt keine Unterstützung für diese Umgebung oder Browser-APIs.
Beispiele
{
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'));
}Ergebnis
capture: false target: false capture: true target: true bubble: true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.