CKTIS / JavaScript
Event.stopPropagation() — спиране на разпространението на събитие
stopPropagation() спира по-нататъшното разпространение на събитието, но не отменя действието по подразбиране и не спира останалите слушатели в текущото извикване.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
event.stopPropagation()event.stopPropagation() е метод от DOM Web API, а не функция на ECMAScript. Връща undefined. Спира по-нататъшното разпространение както по време на улавянето, така и по време на разпространението нагоре по дървото; не отменя вече изпълнените слушатели. Ако бъде извикан върху предшественик по време на улавянето, може да попречи на събитието да достигне целта си.
Не прекъсва текущия callback или останалите слушатели в текущото извикване върху същия обект. stopImmediatePropagation() спира и тези останали слушатели. preventDefault() има друга цел: отменя действието по подразбиране, когато събитието и условията на извикването позволяват това.
В примера улавянето върху parent се случва първо. Първият слушател на child блокира разпространението нагоре към parent, но вторият все пак се изпълнява. defaultPrevented остава false. Изпълнете кода в браузър; наличието на Node 24 не доказва поддръжка на DOM в браузъра.
Примери
const parent = document.createElement('div');
const child = document.createElement('button');
parent.append(child);
const log = [];
parent.addEventListener('demo', () => log.push('parent capture'), true);
parent.addEventListener('demo', () => log.push('parent bubble'));
child.addEventListener('demo', (event) => {
log.push('child first');
event.stopPropagation();
});
child.addEventListener('demo', () => log.push('child second'));
const event = new Event('demo', { bubbles: true, cancelable: true });
child.dispatchEvent(event);
log.push(`defaultPrevented: ${event.defaultPrevented}`);
console.log(log.join('\n'));Резултат
parent capture child first child second defaultPrevented: false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.