CKTIS / JavaScript
EventTarget — odbieranie i wysyłanie zdarzeń
EventTarget to interfejs Web API służący do rejestrowania odbiorców i wysyłania zdarzeń. Samodzielny obiekt można utworzyć bez elementu DOM.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const target = new EventTarget();
target.addEventListener(type, callback, options);
target.removeEventListener(type, callback, options);
const notCanceled = target.dispatchEvent(event);EventTarget jest interfejsem Web API, a nie elementem standardu ECMAScript. new EventTarget() tworzy samodzielny cel zdarzeń, bez rodzica w drzewie propagacji.
addEventListener() rejestruje odbiorcę. removeEventListener() wymaga tego samego typu zdarzenia, tej samej referencji callback i zgodnej wartości capture. Opcja once: true automatycznie usuwa rejestrację odbiorcy przed wywołaniem jego funkcji zwrotnej. Jeśli funkcja ta wyśle nowe zdarzenie tego samego typu do tego samego celu, usunięta rejestracja nie spowoduje ponownego wywołania funkcji.
dispatchEvent() wywołuje odbiorców synchronicznie. Zwraca false, jeśli flaga anulowania zdarzenia jest ustawiona, a w przeciwnym razie zwraca true. W przypadku anulowalnego zdarzenia flagę tę może ustawić zarówno wywołanie preventDefault(), jak i przypisanie event.returnValue = false, zachowane dla zgodności ze starszym kodem. Wynik nie oznacza obecności odbiorcy. Przykład wymaga środowiska udostępniającego EventTarget i Event, ale nie wymaga przeglądarki. Działa bez zmian w Node.js 24, co nie dowodzi zgodności z przeglądarkami.
Przykłady
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);Wynik
ping false true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.