CKTIS / JavaScript
Event.stopPropagation() — gebeurtenispropagatie stoppen
stopPropagation() stopt verdere propagatie van de gebeurtenis, maar annuleert de standaardactie niet en stopt de overige listeners in de huidige aanroep niet.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.stopPropagation()event.stopPropagation() is een methode van de DOM Web API, geen ECMAScript-functie. De methode retourneert undefined. Ze stopt verdere propagatie tijdens zowel de capturefase als het bubbelen; reeds uitgevoerde listeners worden niet ongedaan gemaakt. Als je de methode tijdens het capturen op een voorouder aanroept, kan dat voorkomen dat de gebeurtenis het doel bereikt.
De methode onderbreekt noch de huidige callback, noch de overige listeners in de huidige aanroep op hetzelfde object. stopImmediatePropagation() stopt ook die overige listeners. preventDefault() heeft een ander doel: deze methode annuleert de standaardactie als de gebeurtenis en de voorwaarden van de aanroep dat toelaten.
In het voorbeeld vindt het capturen op parent als eerste plaats. De eerste listener op child blokkeert het bubbelen naar parent, maar de tweede wordt nog steeds uitgevoerd. defaultPrevented blijft false. Voer de code uit in een browser; de aanwezigheid van Node 24 bewijst niet dat de browser-DOM wordt ondersteund.
Voorbeelden
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'));Resultaat
parent capture child first child second defaultPrevented: false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.