Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

EventTarget.addEventListener — rejestrowanie obsługi zdarzeń

EventTarget.addEventListener rejestruje funkcję obsługującą zdarzenie. Opcje capture, once i passive sterują jej wywołaniem oraz możliwością anulowania zdarzenia.

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

target.addEventListener(type, callback, options);
// options: boolean capture, or { capture, once, passive, signal }

EventTarget.addEventListener rejestruje callback dla typu zdarzenia type. Trzeci argument to obiekt opcji albo wartość logiczna oznaczająca capture. To API standardu DOM, nie samego ECMAScript.

capture: true wybiera przechwytywanie zamiast bąbelkowania na przodkach; oba ustawienia dopuszczają obsługę na samym celu. Domyślnie capture i once są false. Przy once: true rejestracja jest usuwana przed wywołaniem callback. Jeśli callback wyśle zdarzenie w ramach zagnieżdżonego wywołania, ta sama rejestracja nie spowoduje ponownego wywołania callback. passive: true uniemożliwia anulowanie przez preventDefault(), ale nie zatrzymuje propagacji. Aby anulować anulowalne zdarzenie, ustaw jawnie passive: false: pominięta opcja nie zawsze oznacza false.

Duplikaty rozpoznawane są po type, tożsamości callback i capture; ponowna rejestracja nie aktualizuje opcji. removeEventListener wymaga tych samych trzech wartości. Przykład używa samodzielnego celu, więc nie demonstruje propagacji między elementami.

Przykłady

const target = new EventTarget();
let calls = 0;
target.addEventListener('demo', (event) => {
  calls++;
  event.preventDefault();
}, { capture: false, once: true, passive: false });

const first = new Event('demo', { cancelable: true });
target.dispatchEvent(first);
target.dispatchEvent(new Event('demo'));
console.log(calls, first.defaultPrevented);

Wynik

1 true

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

Źródła