KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

EventTarget.dispatchEvent(): synchrone gebeurtenisverwerking

dispatchEvent(event) verwerkt een gebeurtenis synchroon op een doel. De booleaanse uitkomst geeft aan of de gebeurtenis is geannuleerd, niet of er listeners zijn.

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.dispatchEvent(event)

target.dispatchEvent(event) verwerkt een Event-object op een EventTarget. Listeners worden synchroon aangeroepen; de methode wacht niet op asynchroon werk dat listeners starten. De gebeurtenis heeft isTrusted === false.

Het resultaat is false als de gebeurtenis is geannuleerd, anders true. preventDefault() annuleert de gebeurtenis alleen bij cancelable: true en buiten een passieve listener. stopPropagation() betekent niet dat de gebeurtenis is geannuleerd.

In een DOM-boom gelden de capturefase en optioneel bubbling (bubbles). Een zelfstandige new EventTarget() heeft geen parent. Uitzonderingen van listeners worden gerapporteerd, maar worden niet doorgegeven aan de aanroeper. Het opnieuw verwerken van het object dat op dat moment wordt verwerkt, veroorzaakt InvalidStateError.

Het voorbeeld laat de synchrone volgorde en annulering zien. Applicatiecode kan de uitkomst gebruiken om het opslaan over te slaan.

Voorbeelden

const target = new EventTarget();
const log = [];

target.addEventListener("save", (event) => {
  log.push("listener");
  event.preventDefault();
});

log.push("before");
const accepted = target.dispatchEvent(
  new Event("save", { cancelable: true })
);
log.push(`after: ${accepted}`);
console.log(log.join(" | "));

Resultaat

before | listener | after: false

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