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.