Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Event.preventDefault() — annullare l’azione predefinita

preventDefault() contrassegna un evento come annullato per impedire l’azione predefinita associata. Richiede cancelable: true e non funziona all’interno di un listener passivo.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

event.preventDefault()

event.preventDefault() segnala l’annullamento di un’azione associata, ad esempio l’invio di un modulo. Restituisce undefined.

La chiamata imposta defaultPrevented su true se cancelable è true e il listener non è passivo. In caso contrario, lascia invariato lo stato di annullamento; in un listener con passive: true, controllare solo cancelable non è sufficiente.

Non interrompe la propagazione né gli altri listener. A questi scopi servono rispettivamente stopPropagation() e stopImmediatePropagation().

L’esempio usa un evento sintetico senza un’azione predefinita integrata. Mostra lo stato di annullamento: dispatchEvent() restituisce false perché l’evento è stato annullato. Questa è una Web API del DOM Standard, non una funzionalità definita da ECMAScript.

Esempi

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);

Risultato

false
false
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti