Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti