CKTIS / JavaScript
Jednorazowy nasłuch zdarzenia z opcją `once`
Ustaw `{ once: true }`, aby dana rejestracja mogła wywołać funkcję obsługi najwyżej raz. Rejestracja jest usuwana jeszcze przed wywołaniem funkcji.
Wersja: Current web platform; runtime support varies
Składnia
target.addEventListener(type, listener);
target.addEventListener(type, listener, { once: true });
target.addEventListener(type, listener, useCapture);Opcja once metody EventTarget.addEventListener należy do obiektu opcji przekazywanego jako trzeci argument. Z { once: true } dana rejestracja może wywołać funkcję obsługi najwyżej raz. Pominięcie once oznacza false. Wartość logiczna true przekazana bezpośrednio jako trzeci argument ustawia capture, a nie once.
API usuwa rejestrację tuż przed wywołaniem funkcji. Dlatego zagnieżdżone wywołanie dispatchEvent() z nowym zdarzeniem tego samego typu nie uruchomi jej ponownie za pośrednictwem tej rejestracji. Wyjątek zgłoszony przez funkcję nie przywraca rejestracji. Jeśli żadne zdarzenie nie dotrze do tej funkcji, sama opcja once nie usunie rejestracji.
Na danym obiekcie docelowym ponowne wywołanie addEventListener() z tym samym typem zdarzenia, tą samą funkcją i tą samą wartością capture nie zmienia istniejącej rejestracji, nawet po zmianie once. Aby zmienić to ustawienie, najpierw użyj removeEventListener() z pasującym typem, funkcją i wartością capture, a potem zarejestruj funkcję ponownie.
EventTarget to interfejs DOM udostępniany przez środowisko wykonawcze, a nie część ECMAScript 2024. Sprawdź obsługę opcji w środowisku, w którym ma działać kod.
Przykłady
{
const target = new EventTarget();
let calls = 0;
target.addEventListener("ready", () => {
calls += 1;
if (calls === 1) target.dispatchEvent(new Event("ready"));
}, { once: true });
target.dispatchEvent(new Event("ready"));
target.dispatchEvent(new Event("ready"));
console.log(`calls: ${calls}`);
}Wynik
calls: 1
Pierwsze wywołanie `dispatchEvent()` uruchamia funkcję. Ani zagnieżdżone wywołanie, ani kolejne wywołanie po jego zakończeniu nie uruchamiają jej ponownie. Oczekiwany wynik: `calls: 1`.
Powiązane lekcje
- JavaScript · Lekcja 39 · Zaawansowany · Wersja: 4