CKTIS / JavaScript
EventTarget — gebeurtenissen ontvangen en verzenden
EventTarget is een Web API-interface voor het registreren van listeners en het verzenden van gebeurtenissen. Je kunt een zelfstandige instantie maken zonder DOM-element.
Versie: 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 is een Web API-interface en geen onderdeel van de ECMAScript-standaard. new EventTarget() maakt een zelfstandig gebeurtenisdoel zonder bovenliggend element in de propagatieboom.
addEventListener() registreert een listener. Voor removeEventListener() zijn hetzelfde gebeurtenistype, dezelfde callbackreferentie en een overeenkomende waarde voor capture vereist. Met once: true wordt de registratie van de listener automatisch verwijderd voordat de callback wordt aangeroepen. Als de callback op hetzelfde doel een nieuwe gebeurtenis van hetzelfde type verzendt, leidt de verwijderde registratie niet tot een nieuwe aanroep.
dispatchEvent() roept listeners synchroon aan. De methode retourneert false als de annuleringsvlag van de gebeurtenis is gezet, en anders true. Bij een annuleerbare gebeurtenis kan die vlag worden gezet door preventDefault() aan te roepen of door de om compatibiliteitsredenen behouden toewijzing event.returnValue = false te gebruiken. Het resultaat geeft niet aan of er een listener bestaat. Het voorbeeld heeft een omgeving nodig die EventTarget en Event beschikbaar stelt, maar geen browser. Het draait ongewijzigd in Node.js 24; dat zegt niets over de compatibiliteit met browsers.
Voorbeelden
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);Resultaat
ping false true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.