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

CKTIS / JavaScript

EventTarget — получаване и изпращане на събития

EventTarget е интерфейс от Web API за регистриране на слушатели и изпращане на събития. Може да се създаде самостоятелен екземпляр без DOM елемент.

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

Синтаксис

const target = new EventTarget();
target.addEventListener(type, callback, options);
target.removeEventListener(type, callback, options);
const notCanceled = target.dispatchEvent(event);

EventTarget е интерфейс от Web API, а не част от стандарта ECMAScript. new EventTarget() създава самостоятелна цел за събития без родител в дървото на разпространение.

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

dispatchEvent() извиква слушателите синхронно. Връща false, ако флагът за отмяна на събитието е зададен; в противен случай връща true. При отменяемо събитие този флаг може да се зададе както с извикване на preventDefault(), така и с присвояването event.returnValue = false, запазено за съвместимост. Резултатът не показва дали има регистриран слушател. Примерът изисква среда, която предоставя EventTarget и Event, но не изисква браузър. Той работи без промени в Node.js 24, което не доказва съвместимост с браузъри.

Примери

const target = new EventTarget();
const log = [];

function onPing(event) {
  log.push(event.type);
  event.preventDefault();
}

target.addEventListener('ping', onPing, { once: true });
const first = target.dispatchEvent(new Event('ping', { cancelable: true }));
const second = target.dispatchEvent(new Event('ping', { cancelable: true }));

console.log(log.join(','));
console.log(first);
console.log(second);

Резултат

ping
false
true

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

Източници