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.