CKTIS / JavaScript
Opcija `passive` u metodi `EventTarget.addEventListener()`
Uz `passive: true` slušatelj prima događaj, ali ne može poništiti njegovu zadanu radnju. Izostavljanje opcije nije uvijek isto što i prosljeđivanje vrijednosti `false`.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
target.addEventListener(type, listener)
target.addEventListener(type, listener, useCapture)
target.addEventListener(type, listener, { passive: true })
target.addEventListener(type, listener, { passive: false })passive je neobavezno logičko svojstvo objekta koji se prosljeđuje kao treći argument metode target.addEventListener(type, listener, options). Samostalna logička vrijednost kao treći argument postavlja samo capture, a ne passive. To je DOM API web-platforme, a ne značajka jezika ECMAScript 2024; provjeri podršku u ciljnom izvršnom okruženju.
Uz passive: true slušatelj se i dalje izvršava, ali njegov poziv event.preventDefault() nema učinka i može izazvati upozorenje u konzoli. To ne mijenja širenje događaja. Uz passive: false slušatelj može spriječiti zadanu radnju pozivom preventDefault(), ali samo ako je event.cancelable jednak true.
Ako izostaviš passive, standard DOM propisuje false kao zadanu vrijednost, osim za wheel, mousewheel, touchstart i touchmove pri registraciji slušatelja na Window, Document, document.documentElement ili document.body: u tim slučajevima propisuje true. Podrška za samu opciju ne jamči primjenu tih zadanih vrijednosti: slučajevi u kojima se true primjenjivao kao zadana vrijednost razlikovali su se ovisno o pregledniku i njegovoj verziji, pa tako i u Safariju. Izričito postavi false ako moraš spriječiti radnju. Ako samo pratiš ulazne događaje, postavi true kako bi preglednik mogao započeti pomicanje sadržaja bez čekanja na slušatelja. Sam događaj scroll nije moguće poništiti.
Ponovna registracija na istom cilju s istom vrstom događaja, istom povratnom funkcijom i istom vrijednošću capture ne mijenja passive. Ukloni slušatelja pomoću removeEventListener() uz odgovarajuću vrstu, funkciju i vrijednost capture, pa ga dodaj ponovno. passive ne sudjeluje u pronalaženju slušatelja pri uklanjanju niti određuje koliko dugo ostaje registriran.
Primjeri
{
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);
}
}Rezultat
passive=true, defaultPrevented=false, dispatchEvent=true passive=false, defaultPrevented=true, dispatchEvent=false
Svaka iteracija šalje novi sintetički događaj koji je moguće poništiti. `defaultPrevented` pokazuje je li poništen, a `dispatchEvent()` vraća `false` samo u iteraciji u kojoj je poništavanje uspjelo. Preglednik može prikazati upozorenje; primjer ne mjeri performanse pomicanja sadržaja.
Povezane lekcije
- JavaScript · Lekcija 33 · Napredno · Verzija: 4
- JavaScript · Lekcija 36 · Napredno · Verzija: 4
- JavaScript · Lekcija 45 · Napredno · Verzija: 4