Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes