База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници