Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

EventTarget.removeEventListener — usuwanie nasłuchiwania zdarzeń

removeEventListener() usuwa nasłuchiwacz, dopasowując typ zdarzenia, tożsamość callback i wartość capture na tym samym obiekcie docelowym.

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.removeEventListener(type, callback[, options])

EventTarget.removeEventListener usuwa nasłuchiwacz zarejestrowany przez addEventListener(). Zwraca undefined; brak dopasowania niczego nie zmienia.

Muszą zgadzać się obiekt docelowy, type, tożsamość callback oraz capture. Zachowaj referencję do funkcji: nowa funkcja o identycznym kodzie nie pasuje. Dotyczy to również obiektów z handleEvent().

options przyjmuje wartość logiczną lub obiekt z capture; domyślnie jest to false. passive, once i signal nie uczestniczą w dopasowaniu. Rejestracje z capture: true i capture: false wymagają oddzielnego usunięcia.

Przykłady

const target = new EventTarget();
let calls = 0;
function handler() {
  calls += 1;
}

target.addEventListener("ping", handler, true);
target.removeEventListener("ping", handler, false);
target.dispatchEvent(new Event("ping"));
console.log(calls);

target.removeEventListener("ping", handler, { capture: true });
target.dispatchEvent(new Event("ping"));
console.log(calls);

Wynik

1
1

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

Źródła