CKTIS / JavaScript
HTMLInputElement.validity — stato di validità del campo
HTMLInputElement.validity espone lo stato attuale di convalida dei vincoli di un campo come oggetto ValidityState. I suoi indicatori segnalano problemi specifici, mentre valid indica se non è attivo alcun indicatore 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.validity
input.validity.valid
input.validity.valueMissingHTMLInputElement.validity è una proprietà di sola lettura che restituisce un oggetto ValidityState live: un riferimento salvato riflette le modifiche successive del campo. Anche i suoi indicatori sono di sola lettura. Questa API del browser è definita da HTML, non da ECMAScript; la sola disponibilità di Node.js non ne garantisce il supporto.
valueMissing indica l’assenza di un valore obbligatorio, typeMismatch un formato non conforme al tipo e patternMismatch una mancata corrispondenza con pattern. Gli altri indicatori di errore sono tooLong, tooShort, rangeUnderflow, rangeOverflow, stepMismatch, badInput e customError. La loro applicabilità dipende dal tipo di campo e dai vincoli. valid vale true quando tutti gli indicatori di errore valgono false.
Leggere validity non visualizza messaggi né attiva invalid. checkValidity() controlla il controllo e può attivare invalid; reportValidity() può anche mostrare il problema all’utente. willValidate determina la partecipazione alla convalida: un campo disabilitato può avere comunque indicatori di errore anche se non partecipa al controllo.
setCustomValidity('Blocked') imposta customError; cancellalo con setCustomValidity(''). Correggere il valore, da solo, non cancella l’errore. L’esempio mostra gli aggiornamenti tramite l’oggetto state salvato, senza rileggere input.validity. La convalida del browser non sostituisce i controlli dei dati lato server.
Esempi
const input = document.createElement('input');
input.type = 'email';
input.required = true;
const state = input.validity;
console.log(state.valueMissing, state.valid);
input.value = 'learner@example.com';
console.log(state.valueMissing, state.valid);
input.setCustomValidity('Blocked');
console.log(state.customError, state.valid);
input.setCustomValidity('');
console.log(state.customError, state.valid);Risultato
true false false true true 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.