KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Event.preventDefault() — de standaardactie annuleren

preventDefault() markeert een gebeurtenis als geannuleerd om de bijbehorende standaardactie te voorkomen. Vereist cancelable: true en werkt niet in een passieve listener.

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

event.preventDefault()

event.preventDefault() geeft aan dat een bijbehorende actie wordt geannuleerd, zoals het verzenden van een formulier. De methode retourneert undefined.

De aanroep stelt defaultPrevented in op true als cancelable true is en de listener niet passief is. Anders blijft de annuleringsstatus ongewijzigd; in een listener met passive: true is alleen cancelable controleren niet voldoende.

De methode stopt noch de propagatie, noch andere listeners. Gebruik daarvoor respectievelijk stopPropagation() en stopImmediatePropagation().

Het voorbeeld gebruikt een synthetische gebeurtenis zonder ingebouwde standaardactie. Het laat de annuleringsstatus zien: dispatchEvent() retourneert false omdat de gebeurtenis is geannuleerd. Dit is een Web API uit de DOM Standard, geen functie die door ECMAScript is gedefinieerd.

Voorbeelden

const target = new EventTarget();
target.addEventListener("demo", (event) => {
  event.preventDefault();
}, { passive: false });

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

Resultaat

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

Bronnen