CKTIS / JavaScript
HTMLFormElement.checkValidity() — verificare la validità di un modulo
Il metodo form.checkValidity() verifica i vincoli dei controlli associati a un modulo e restituisce un valore booleano. Non invia il modulo e non mostra i messaggi di convalida standard del browser.
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
form.checkValidity()HTMLFormElement.checkValidity è un metodo della Web API del browser, non una funzione definita da ECMAScript. La chiamata form.checkValidity() non accetta argomenti e restituisce sincronicamente true se ogni controllo che può essere convalidato rispetta i propri vincoli; altrimenti restituisce false.
La verifica riguarda i controlli associati al modulo, non soltanto i suoi discendenti. I controlli disattivati tramite disabled vengono ignorati. Se nessun controllo può essere convalidato, il risultato è true. Il metodo attiva un evento invalid su ogni controllo non valido; annullare l’evento non modifica il risultato trasformandolo in true.
Il metodo non invia il modulo e non mostra autonomamente l’interfaccia standard degli errori. Usa form.reportValidity() per verificare i problemi e segnalarli all’utente. La convalida nel browser non sostituisce quella lato server.
L’esempio crea un modulo con un campo di testo obbligatorio. Il campo vuoto produce false e un evento invalid; dopo aver assegnato Ada, il risultato è true. Esegui il codice in un browser: un ambiente Node.js 24 da solo non dimostra che questa API sia disponibile.
Esempi
(() => {
const form = document.createElement('form');
const input = document.createElement('input');
input.required = true;
form.append(input);
let invalidEvents = 0;
input.addEventListener('invalid', () => { invalidEvents += 1; });
console.log(form.checkValidity());
input.value = 'Ada';
console.log(form.checkValidity());
console.log(invalidEvents);
})();Risultato
false 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.