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

CKTIS / JavaScript

EventTarget.addEventListener — регистриране на слушатели на събития

EventTarget.addEventListener регистрира callback функция за събитие. Опциите capture, once и passive управляват извикването ѝ и дали слушателят може да отмени събитието.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

target.addEventListener(type, callback, options);
// options: boolean capture, or { capture, once, passive, signal }

EventTarget.addEventListener регистрира callback за типа събитие type. Третият аргумент е обект с опции или булева стойност, която указва capture. Този API е част от стандарта DOM, а не от самия ECMAScript.

capture: true избира фазата на прихващане вместо bubbling при предците; и двете настройки позволяват извикване върху самата цел. Стойностите по подразбиране за capture и once са false. При once: true регистрацията се премахва, преди да бъде извикан callback. Ако callback изпрати събитие по време на това извикване, вложеното изпращане не може да извика callback повторно чрез същата регистрация. passive: true предотвратява отмяна чрез preventDefault(), но не спира разпространението. За да отмениш събитие, което може да бъде отменено, задай изрично passive: false: пропускането на опцията не винаги означава false.

Дубликатите се разпознават по type, идентичността на callback и capture; повторната регистрация не актуализира опциите. removeEventListener изисква същите три стойности. Примерът използва самостоятелна цел, затова не показва разпространение между елементи.

Примери

const target = new EventTarget();
let calls = 0;
target.addEventListener('demo', (event) => {
  calls++;
  event.preventDefault();
}, { capture: false, once: true, passive: false });

const first = new Event('demo', { cancelable: true });
target.dispatchEvent(first);
target.dispatchEvent(new Event('demo'));
console.log(calls, first.defaultPrevented);

Резултат

1 true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници