Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Event.stopPropagation() — zaustavljanje širenja događaja

stopPropagation() zaustavlja daljnje širenje događaja, ali ne poništava zadanu radnju niti zaustavlja preostale slušatelje u trenutačnom pozivu.

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

Sintaksa

event.stopPropagation()

event.stopPropagation() metoda je DOM Web API-ja, a ne funkcija ECMAScripta. Vraća undefined. Zaustavlja daljnje širenje tijekom faze hvatanja i tijekom bubrenja; ne poništava već izvršene slušatelje. Ako se pozove na pretku tijekom hvatanja, može spriječiti da događaj dođe do cilja.

Ne prekida trenutačni callback ni preostale slušatelje u trenutačnom pozivu na istom objektu. stopImmediatePropagation() zaustavlja i te preostale slušatelje. preventDefault() ima drukčiju svrhu: poništava zadanu radnju kada to dopuštaju događaj i uvjeti poziva.

U primjeru se hvatanje na parent odvija prvo. Prvi slušatelj na child blokira bubrenje prema parent, ali drugi se ipak izvršava. defaultPrevented ostaje false. Pokreni kôd u pregledniku; sama prisutnost Node 24 ne dokazuje podršku za DOM preglednika.

Primjeri

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

Rezultat

parent capture
child first
child second
defaultPrevented: false

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori