База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Опцията `passive` в `EventTarget.addEventListener()`

При `passive: true` слушателят получава събитието, но не може да отмени действието му по подразбиране. Пропускането на опцията невинаги е равнозначно на `false`.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

target.addEventListener(type, listener)
target.addEventListener(type, listener, useCapture)
target.addEventListener(type, listener, { passive: true })
target.addEventListener(type, listener, { passive: false })

passive е незадължително булево свойство на обекта, подаден като трети аргумент на target.addEventListener(type, listener, options). Ако третият аргумент е само булева стойност, той задава capture, а не passive. Това е DOM API на уеб платформата, а не възможност на езика ECMAScript 2024; провери поддръжката в целевата среда за изпълнение.

При passive: true слушателят продължава да се изпълнява, но извикването на event.preventDefault() от него няма ефект и може да предизвика предупреждение в конзолата. Това не променя разпространението на събитието. При passive: false слушателят може да отмени действието по подразбиране с preventDefault(), но само ако event.cancelable е true.

Ако пропуснеш passive, стандартът DOM задава false като стойност по подразбиране, освен за wheel, mousewheel, touchstart и touchmove при регистрация върху Window, Document, document.documentElement или document.body: в тези случаи той задава true. Поддръжката на самата опция не гарантира прилагането на тези стойности по подразбиране: случаите, в които се е използвало true по подразбиране, са се различавали според браузъра и версията му, включително при Safari. Задай изрично false, ако трябва да отмениш действието. Използвай true, ако само следиш входните събития, за да може браузърът да започне превъртането, без да чака слушателя. Самото събитие scroll не може да бъде отменено.

Повторната регистрация върху същата цел със същия тип, същата функция и същата стойност на capture не променя passive. Премахни слушателя чрез removeEventListener() със съответния тип, функция и стойност на capture, след което го добави отново. passive не участва в определянето кой слушател да се премахне и не управлява продължителността на регистрацията му.

Примери

{
  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);
  }
}

Резултат

passive=true, defaultPrevented=false, dispatchEvent=true
passive=false, defaultPrevented=true, dispatchEvent=false

Всяка итерация изпраща ново синтетично събитие, което може да бъде отменено. `defaultPrevented` показва дали е отменено, а `dispatchEvent()` връща `false` само в итерацията, в която отмяната успява. Браузърът може да покаже предупреждение; примерът не измерва производителността при превъртане.

Свързани уроци

  • JavaScript · Урок 33 · Напреднало · Версия: 4
  • JavaScript · Урок 36 · Напреднало · Версия: 4
  • JavaScript · Урок 45 · Напреднало · Версия: 4

Източници