CKTIS / JavaScript
HTMLInputElement.checkValidity() — verificare la validità di un campo
Il metodo checkValidity() verifica i vincoli di un singolo campo input e restituisce un valore booleano. Se il campo non è valido e partecipa alla convalida, genera invalid, ma non visualizza direttamente un messaggio di errore.
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
input.checkValidity()HTMLInputElement.checkValidity è un metodo di istanza che si chiama senza argomenti come input.checkValidity(). Restituisce false se il campo partecipa alla convalida e non rispetta i suoi vincoli; altrimenti restituisce true.
I vincoli dipendono dal tipo di campo e da attributi come required, pattern, min e max. Un campo disabled non partecipa alla convalida: quindi true non significa necessariamente che il suo valore sia valido. La proprietà willValidate indica se il campo vi partecipa.
Con un risultato false, il metodo genera un evento invalid; annullarlo non cambia il risultato. A differenza di reportValidity(), non visualizza un messaggio di errore. Non invia il modulo né controlla gli altri campi.
Questa API del browser è definita dall’HTML Living Standard, non da ECMAScript. È supportata dai motori dei browser attuali; la presenza di Node 24 in un repository non dimostra il supporto di questa API.
Esempi
const input = document.createElement('input');
input.type = 'text';
input.required = true;
let invalidEvents = 0;
input.addEventListener('invalid', () => { invalidEvents += 1; });
console.log(input.checkValidity());
input.value = 'Ada';
console.log(input.checkValidity());
input.value = '';
input.disabled = true;
console.log(input.checkValidity());
console.log(invalidEvents);Risultato
false true true 1
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.