Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti