CKTIS / JavaScript
Opcja `passive` w `EventTarget.addEventListener()`
`passive: true` pozwala procedurze obsługi odebrać zdarzenie, ale nie pozwala jej anulować jego domyślnej akcji. Pominięcie opcji nie zawsze oznacza `false`.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
target.addEventListener(type, listener)
target.addEventListener(type, listener, useCapture)
target.addEventListener(type, listener, { passive: true })
target.addEventListener(type, listener, { passive: false })passive to opcjonalna właściwość logiczna obiektu przekazywanego jako trzeci argument metody target.addEventListener(type, listener, options). W wariancie z wartością logiczną trzeci argument ustawia tylko capture, nie passive. To API DOM platformy webowej, a nie funkcja języka ECMAScript 2024; sprawdź obsługę w docelowym środowisku.
Przy passive: true procedura obsługi nadal się wykonuje, ale jej wywołanie event.preventDefault() nie ma skutku i może wywołać ostrzeżenie w konsoli. Nie zmienia to propagacji zdarzenia. passive: false pozwala anulować domyślną akcję przez preventDefault(), ale tylko jeśli event.cancelable ma wartość true.
Jeśli pominiesz passive, standard DOM przewiduje wartość false, z wyjątkiem zdarzeń wheel, mousewheel, touchstart i touchmove przy rejestracji na Window, Document, document.documentElement lub document.body: w tych przypadkach przewiduje true. Obsługa samej opcji nie gwarantuje zgodności z tą regułą: przeglądarki, w tym Safari, różniły się między wersjami pod względem tego, kiedy domyślnie stosowały true. Ustaw jawnie false, jeśli musisz anulować akcję, a true, jeśli tylko obserwujesz zdarzenie wejściowe i przeglądarka nie musi czekać na zakończenie obsługi, by zacząć przewijanie. Samego zdarzenia scroll nie można anulować.
Ponowna rejestracja na tym samym obiekcie z tym samym typem, tą samą funkcją obsługi i tą samą wartością capture nie zmienia passive. Usuń rejestrację przez removeEventListener() z tym samym typem, funkcją i wartością capture, a potem dodaj ją ponownie. passive nie wpływa na dopasowanie przy usuwaniu ani na czas życia rejestracji.
Przykłady
{
const target = new EventTarget();
const type = "passive-demo";
const listener = (event) => event.preventDefault();
for (const passive of [true, false]) {
target.addEventListener(type, listener, { passive });
const event = new Event(type, { cancelable: true });
const result = target.dispatchEvent(event);
console.log(`passive=${passive}, defaultPrevented=${event.defaultPrevented}, dispatchEvent=${result}`);
target.removeEventListener(type, listener);
}
}Wynik
passive=true, defaultPrevented=false, dispatchEvent=true passive=false, defaultPrevented=true, dispatchEvent=false
Każdy przebieg wysyła nowe, anulowalne zdarzenie syntetyczne. `defaultPrevented` pokazuje, czy je anulowano, a `dispatchEvent()` zwraca `false` tylko w przebiegu, w którym anulowanie się powiodło. Ostrzeżenie przeglądarki może się pojawić; przykład nie mierzy wydajności przewijania.
Powiązane lekcje
- JavaScript · Lekcja 33 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 36 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 45 · Zaawansowany · Wersja: 4