CKTIS / JavaScript
Event.preventDefault() — cancelar a ação predefinida
preventDefault() marca um evento como cancelado para impedir a ação predefinida associada. Requer cancelable: true e não funciona num listener passivo.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
event.preventDefault()event.preventDefault() assinala o cancelamento de uma ação associada, como o envio de um formulário. Devolve undefined.
A chamada define defaultPrevented como true se cancelable for true e o listener não for passivo. Caso contrário, não altera o estado de cancelamento; num listener com passive: true, verificar apenas cancelable não é suficiente.
Não interrompe a propagação nem os outros listeners. Para esses efeitos, use, respetivamente, stopPropagation() e stopImmediatePropagation().
O exemplo usa um evento sintético sem uma ação predefinida integrada. Demonstra o estado de cancelamento: dispatchEvent() devolve false porque o evento foi cancelado. Esta é uma Web API do DOM Standard, não uma funcionalidade definida pelo ECMAScript.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.