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.