CKTIS / JavaScript
EventTarget – Ereignisse empfangen und auslösen
EventTarget ist eine Web-API-Schnittstelle, mit der Listener registriert und Ereignisse ausgelöst werden. Eine eigenständige Instanz lässt sich ohne DOM-Element erstellen.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const target = new EventTarget();
target.addEventListener(type, callback, options);
target.removeEventListener(type, callback, options);
const notCanceled = target.dispatchEvent(event);EventTarget ist eine Web-API-Schnittstelle und kein Bestandteil des ECMAScript-Standards. new EventTarget() erstellt ein eigenständiges Ereignisziel ohne übergeordnetes Element im Ausbreitungsbaum.
addEventListener() registriert einen Listener. Bei removeEventListener() müssen Ereignistyp und Callback-Referenz identisch sein und der Wert von capture übereinstimmen. Mit once: true wird die Registrierung des Listeners automatisch entfernt, bevor der Callback aufgerufen wird. Löst der Callback am selben Ziel ein neues Ereignis desselben Typs aus, führt die entfernte Registrierung nicht zu einem erneuten Aufruf.
dispatchEvent() ruft Listener synchron auf. Die Methode gibt false zurück, wenn das Abbruchflag des Ereignisses gesetzt ist, andernfalls true. Bei einem abbrechbaren Ereignis kann dieses Flag sowohl durch einen Aufruf von preventDefault() als auch durch die aus Kompatibilitätsgründen beibehaltene Zuweisung event.returnValue = false gesetzt werden. Das Ergebnis sagt nicht aus, ob ein Listener vorhanden ist. Das Beispiel benötigt eine Umgebung, die EventTarget und Event bereitstellt, aber keinen Browser. Es läuft unverändert in Node.js 24; das belegt jedoch keine Browserkompatibilität.
Beispiele
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);Ergebnis
ping false true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.