CKTIS / JavaScript
Event.preventDefault() — die Standardaktion abbrechen
preventDefault() kennzeichnet ein Ereignis als abgebrochen, um die zugehörige Standardaktion zu verhindern. Erfordert cancelable: true und funktioniert nicht in einem passiven Listener.
Version: 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() signalisiert den Abbruch einer zugehörigen Aktion, zum Beispiel des Absenden eines Formulars. Die Methode gibt undefined zurück.
Der Aufruf setzt defaultPrevented auf true, wenn cancelable den Wert true hat und der Listener nicht passiv ist. Andernfalls bleibt der Abbruchstatus unverändert; in einem Listener mit passive: true reicht es nicht aus, nur cancelable zu prüfen.
Die Methode verhindert weder die Weitergabe des Ereignisses noch die Ausführung anderer Listener. Dafür dienen stopPropagation() beziehungsweise stopImmediatePropagation().
Das Beispiel verwendet ein synthetisches Ereignis ohne integrierte Standardaktion. Es veranschaulicht den Abbruchstatus: dispatchEvent() gibt false zurück, weil das Ereignis abgebrochen wurde. Dies ist eine Web API des DOM Standard und keine von ECMAScript definierte Funktionalität.
Beispiele
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);Ergebnis
false false true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.