Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

ValidityState — stato di convalida di un campo del modulo

ValidityState espone flag di errore di sola lettura per un campo del modulo. Permette di distinguere un valore obbligatorio mancante, un formato non valido e un testo troppo corto, con un’importante eccezione per i valori assegnati dagli script.

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

const state = input.validity;
state.valid;
state.valueMissing;
state.typeMismatch;
state.tooShort;

ValidityState è un’interfaccia della HTML Web API, non fa parte di ECMAScript. L’oggetto disponibile tramite input.validity viene aggiornato in tempo reale; i suoi flag booleani sono di sola lettura. ValidityState.valid vale true quando nessuno degli altri flag di errore è impostato.

ValidityState.valueMissing segnala che il vincolo required non è soddisfatto: per un campo di testo significa che il valore è vuoto. ValidityState.typeMismatch significa che un valore non rispetta le regole del tipo email o url, non quelle di un tipo di dato JavaScript. Un indirizzo email vuoto non causa da solo questo errore.

ValidityState.tooShort si applica a un valore non vuoto più corto di minlength in un campo che supporta questo vincolo. Il flag dirty value deve essere impostato e l’ultima modifica del valore deve essere stata effettuata dall’utente. Assegnare .value non attiva questo controllo della lunghezza; minlength da solo non richiede che venga inserito un valore.

L’esempio conserva un unico oggetto di stato e lo legge dopo le modifiche. Per 'x', tooShort resta false, perché il valore viene assegnato da uno script. Eseguilo in un browser; la presenza di Node 24 nel repository non dimostra il supporto di questa API.

Esempi

(() => {
  const input = document.createElement('input');
  input.type = 'email';
  input.required = true;
  input.minLength = 8;
  const state = input.validity;

  const show = () => console.log(JSON.stringify({
    valid: state.valid,
    valueMissing: state.valueMissing,
    typeMismatch: state.typeMismatch,
    tooShort: state.tooShort
  }));

  show();
  input.value = 'x';
  show();
  input.value = 'a@example.com';
  show();
})();

Risultato

{"valid":false,"valueMissing":true,"typeMismatch":false,"tooShort":false}
{"valid":false,"valueMissing":false,"typeMismatch":true,"tooShort":false}
{"valid":true,"valueMissing":false,"typeMismatch":false,"tooShort":false}

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