CKTIS / JavaScript
Event.stopPropagation() — Ereignisweitergabe stoppen
stopPropagation() stoppt die weitere Weitergabe eines Ereignisses, hebt aber weder die Standardaktion auf noch verhindert es die übrigen Listener im aktuellen Aufruf.
Version: 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() ist eine Methode der DOM Web API und keine ECMAScript-Funktion. Sie gibt undefined zurück. Sie stoppt die weitere Weitergabe sowohl während der Erfassungsphase als auch während des Bubblings; bereits ausgeführte Listener werden nicht rückgängig gemacht. Wird die Methode während der Erfassung auf einem Vorfahren aufgerufen, kann das verhindern, dass das Ereignis sein Ziel erreicht.
Sie unterbricht weder den aktuellen Callback noch die übrigen Listener im aktuellen Aufruf auf demselben Objekt. stopImmediatePropagation() stoppt auch diese übrigen Listener. preventDefault() hat eine andere Aufgabe: Die Methode hebt die Standardaktion auf, wenn das Ereignis und die Bedingungen des Aufrufs dies zulassen.
Im Beispiel findet die Erfassung auf parent zuerst statt. Der erste child-Listener verhindert das Bubbling zu parent, der zweite wird aber trotzdem ausgeführt. defaultPrevented bleibt false. Führe den Code in einem Browser aus; das Vorhandensein von Node 24 belegt keine Unterstützung für das Browser-DOM.
Beispiele
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'));Ergebnis
parent capture child first child second defaultPrevented: false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.