KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

EventTarget.addEventListener — eventlisteners registreren

EventTarget.addEventListener registreert een callback voor een gebeurtenis. De opties capture, once en passive bepalen wanneer deze wordt aangeroepen en of de listener de gebeurtenis kan annuleren.

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

target.addEventListener(type, callback, options);
// options: boolean capture, or { capture, once, passive, signal }

EventTarget.addEventListener registreert een callback voor gebeurtenistype type. Het derde argument is een optieobject of een booleaanse waarde die capture aangeeft. Deze API hoort bij de DOM-standaard, niet bij ECMAScript zelf.

capture: true kiest op voorouders voor de capturefase in plaats van bubbling; met beide instellingen kan de callback op het doel zelf worden aangeroepen. Zowel capture als once is standaard false. Met once: true wordt de registratie verwijderd voordat callback wordt aangeroepen. Als callback tijdens die aanroep een gebeurtenis dispatcht, kan die geneste dispatch callback niet opnieuw via dezelfde registratie aanroepen. passive: true verhindert annulering via preventDefault(), maar stopt de propagatie niet. Stel expliciet passive: false in om een annuleerbare gebeurtenis te annuleren: het weglaten van de optie betekent niet altijd false.

Duplicaten worden herkend aan type, de identiteit van callback en capture; opnieuw registreren werkt de opties niet bij. removeEventListener vereist dezelfde drie waarden. Het voorbeeld gebruikt een zelfstandig doel en laat daarom geen propagatie tussen elementen zien.

Voorbeelden

const target = new EventTarget();
let calls = 0;
target.addEventListener('demo', (event) => {
  calls++;
  event.preventDefault();
}, { capture: false, once: true, passive: false });

const first = new Event('demo', { cancelable: true });
target.dispatchEvent(first);
target.dispatchEvent(new Event('demo'));
console.log(calls, first.defaultPrevented);

Resultaat

1 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.

Bronnen