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.