Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Event.stopPropagation() — zatrzymywanie propagacji zdarzenia

stopPropagation() zatrzymuje dalszą propagację zdarzenia, ale nie anuluje działania domyślnego ani pozostałych listenerów w bieżącym wywołaniu.

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

Składnia

event.stopPropagation()

event.stopPropagation() to metoda DOM Web API, nie funkcja ECMAScript. Zwraca undefined. Zatrzymuje dalszą propagację zarówno podczas przechwytywania, jak i bąbelkowania; nie cofa wykonanych listenerów. Wywołana na przodku podczas przechwytywania może uniemożliwić dotarcie zdarzenia do celu.

Nie przerywa bieżącego callbacku ani pozostałych listenerów w bieżącym wywołaniu na tym samym obiekcie. stopImmediatePropagation() zatrzymuje także te pozostałe listenery. preventDefault() ma inne zadanie: anuluje działanie domyślne, jeśli zdarzenie i warunki wywołania na to pozwalają.

W przykładzie przechwytywanie na parent zachodzi najpierw. Pierwszy listener child blokuje bąbelkowanie do parent, ale drugi nadal działa. defaultPrevented pozostaje false. Uruchom kod w przeglądarce; obecność Node 24 nie dowodzi obsługi przeglądarkowego DOM.

Przykłady

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

Wynik

parent capture
child first
child second
defaultPrevented: false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła