Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Event.bubbles — bąbelkowanie zdarzeń

Event.bubbles to właściwość logiczna tylko do odczytu, określająca, czy zdarzenie może bąbelkować od celu do jego przodków. Wartość false nie wyłącza przechwytywania ani obsługi na samym celu.

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

Składnia

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

Event.bubbles zwraca wartość logiczną określoną podczas inicjalizacji zdarzenia. W konstruktorze new Event(type, options) opcja bubbles domyślnie wynosi false; ustawienie { bubbles: true } włącza bąbelkowanie.

Bąbelkowanie przebiega od celu ku jego przodkom. false nie blokuje fazy przechwytywania ani wywołania odbiorców na celu. Przykład pokazuje obie konfiguracje na odłączonym drzewie DOM.

bubbles nie informuje, czy propagacja rzeczywiście dotarła do przodka: stopPropagation() może ją zatrzymać bez zmiany tej właściwości. cancelable dotyczy anulowania przez preventDefault(), a composed — przekraczania granic Shadow DOM; są to osobne ustawienia.

To API standardu DOM, nie samego ECMAScript. Przykład wymaga przeglądarkowego DOM; obecność Node 24 w repozytorium nie potwierdza obsługi tego środowiska ani API przeglądarkowych.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła