CKTIS / JavaScript
Event.preventDefault() — cancelar la acción predeterminada
preventDefault() marca un evento como cancelado para impedir la acción predeterminada asociada. Requiere cancelable: true y no funciona dentro de un listener pasivo.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
event.preventDefault()event.preventDefault() indica la cancelación de una acción asociada, como el envío de un formulario. Devuelve undefined.
La llamada establece defaultPrevented en true si cancelable es true y el listener no es pasivo. De lo contrario, deja sin cambios el estado de cancelación; dentro de un listener con passive: true, no basta con comprobar únicamente cancelable.
No detiene la propagación ni otros listeners. Para esos fines se usan, respectivamente, stopPropagation() y stopImmediatePropagation().
El ejemplo utiliza un evento sintético sin una acción predeterminada integrada. Muestra el estado de cancelación: dispatchEvent() devuelve false porque el evento se canceló. Se trata de una API web del DOM Standard, no de una funcionalidad definida por ECMAScript.
Ejemplos
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);Resultado
false false true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.