Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes