CKTIS / JavaScript
Event.bubbles — разпространение на събития с изплуване
Event.bubbles е логическо свойство само за четене, което показва дали дадено събитие може да се разпространява от целта си към предците ѝ. Стойността false не изключва фазата на прихващане или обработването на самата цел.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
event.bubbles
new Event(type, { bubbles: true })Event.bubbles връща логическата стойност, зададена при инициализирането на събитието. При new Event(type, options) опцията bubbles по подразбиране е false; задаването на { bubbles: true } включва разпространението с изплуване.
Разпространението с изплуване започва от целта и продължава към предците ѝ. false не възпрепятства фазата на прихващане или извикването на слушатели върху целта. Примерът показва и двете конфигурации в отделено DOM дърво.
bubbles не показва дали разпространението действително е достигнало предшественик: stopPropagation() може да го спре, без да промени това свойство. cancelable се отнася до отмяната чрез preventDefault(), а composed — до преминаването през границите на Shadow DOM; това са отделни настройки.
Този API е част от стандарта DOM, а не от самия ECMAScript. Примерът изисква DOM на браузър; наличието на Node 24 в хранилище не доказва поддръжка на тази среда или на API на браузъра.
Примери
{
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'));
}Резултат
capture: false target: false capture: true target: true bubble: true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.