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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.