WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen