Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Možnost `passive` v `EventTarget.addEventListener()`

Pri `passive: true` poslušalec prejme dogodek, ne more pa preklicati njegovega privzetega dejanja. Izpuščena možnost ne pomeni vedno vrednosti `false`.

Različica: 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 neobvezna logična lastnost objekta, ki ga kot tretji argument podaš metodi target.addEventListener(type, listener, options). Če je tretji argument samo logična vrednost, nastavi le capture, ne pa passive. To je vmesnik DOM spletne platforme, ne zmožnost jezika ECMAScript 2024; preveri podporo v ciljnem izvajalnem okolju.

Pri passive: true se poslušalec vseeno izvede, vendar njegov klic event.preventDefault() nima učinka in lahko sproži opozorilo v konzoli. To ne spremeni širjenja dogodka. Pri passive: false lahko poslušalec prekliče privzeto dejanje z preventDefault(), vendar le, če je event.cancelable enak true.

Če izpustiš passive, standard DOM določa privzeto vrednost false, razen za dogodke wheel, mousewheel, touchstart in touchmove, ko poslušalca registriraš na Window, Document, document.documentElement ali document.body: v teh primerih določa true. Podpora sami možnosti še ne pomeni, da brskalnik uporablja te privzete vrednosti: primeri, v katerih je bila privzeta vrednost true, so se razlikovali glede na brskalnik in njegovo različico, tudi pri Safariju. Če moraš dejanje preklicati, izrecno nastavi false. Če vhodne dogodke le opazuješ, uporabi true, da lahko brskalnik začne pomikati vsebino, ne da bi čakal na poslušalca. Samega dogodka scroll ni mogoče preklicati.

Ponovna registracija na istem cilju z isto vrsto dogodka, isto povratno funkcijo in isto vrednostjo capture ne spremeni passive. Z removeEventListener() odstrani poslušalca z ujemajočo se vrsto, funkcijo in vrednostjo capture, nato ga dodaj znova. passive se ne uporablja pri iskanju poslušalca za odstranitev in ne določa njegove življenjske dobe.

Primeri

{
  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

Vsaka ponovitev razpošlje nov sintetični dogodek, ki ga je mogoče preklicati. `defaultPrevented` pokaže, ali je bil preklican, `dispatchEvent()` pa vrne `false` samo v ponovitvi, v kateri je preklic uspel. Brskalnik lahko prikaže opozorilo; primer ne meri zmogljivosti pomikanja.

Povezane lekcije

  • JavaScript · Lekcija 33 · Napredna · Različica: 4
  • JavaScript · Lekcija 36 · Napredna · Različica: 4
  • JavaScript · Lekcija 45 · Napredna · Različica: 4

Viri