CKTIS / JavaScript
Event.preventDefault() — zrušení výchozí akce
preventDefault() označí událost jako zrušenou, aby zabránila související výchozí akci. Vyžaduje cancelable: true a nefunguje v pasivním posluchači.
Verze: 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() signalizuje zrušení související akce, například odeslání formuláře. Vrací undefined.
Volání nastaví defaultPrevented na true, pokud je cancelable rovno true a posluchač není pasivní. Jinak stav zrušení nezmění; v posluchači s passive: true nestačí kontrolovat pouze cancelable.
Nezastavuje šíření události ani ostatní posluchače. K tomu slouží stopPropagation() a stopImmediatePropagation(), v uvedeném pořadí.
Příklad používá syntetickou událost bez vestavěné výchozí akce. Ukazuje stav zrušení: dispatchEvent() vrátí false, protože událost byla zrušena. Jde o Web API z DOM Standard, nikoli o funkci definovanou v ECMAScriptu.
Příklady
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);Výsledek
false false true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.