WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen