Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Event.preventDefault() — annuler l’action par défaut

preventDefault() marque un événement comme annulé afin d’empêcher l’action par défaut qui lui est associée. La méthode nécessite cancelable: true et ne fonctionne pas dans un écouteur passif.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

event.preventDefault()

event.preventDefault() signale l’annulation d’une action associée, comme l’envoi d’un formulaire. La méthode renvoie undefined.

L’appel définit defaultPrevented sur true si cancelable vaut true et si l’écouteur n’est pas passif. Sinon, il ne modifie pas l’état d’annulation ; dans un écouteur avec passive: true, vérifier uniquement cancelable ne suffit pas.

La méthode n’arrête ni la propagation de l’événement ni les autres écouteurs. Utilisez respectivement stopPropagation() et stopImmediatePropagation() à ces fins.

L’exemple utilise un événement synthétique sans action par défaut intégrée. Il illustre l’état d’annulation : dispatchEvent() renvoie false parce que l’événement a été annulé. Il s’agit d’une API Web du DOM Standard, et non d’une fonctionnalité définie par ECMAScript.

Exemples

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);

Résultat

false
false
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources