Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

ValidityState: validità complessiva e cause degli errori

Leggi `element.validity` per distinguere un campo valido da un valore obbligatorio mancante, un formato errato o un valore troppo corto inserito dall’utente.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

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

element.validity restituisce un oggetto ValidityState associato a un controllo del modulo. Le sue proprietà booleane sono di sola lettura e riflettono lo stato attuale: conservare l’oggetto non ne congela i valori. È un’API della piattaforma web, non di ECMAScript.

valid è true solo quando nessun indicatore di errore è attivo, inclusi quelli non descritti qui, come customError. Più indicatori possono essere true contemporaneamente. valueMissing è true quando manca il valore richiesto da required, per esempio in un campo e-mail obbligatorio lasciato vuoto.

typeMismatch è true se un valore non vuoto non rispetta le regole di sintassi HTML per type="email" o type="url". Per il tipo e-mail, multiple consente di indicare più indirizzi separati da virgole. In un campo e-mail obbligatorio vuoto si attiva valueMissing, non typeMismatch. Il controllo della sintassi non dimostra che un indirizzo esista.

tooShort è true se minlength si applica a un input o a una textarea, il flag di modifica (dirty value flag) è impostato, l’ultima modifica del valore è stata fatta dall’utente e il valore non vuoto esposto dall’API ha meno unità di codice UTF-16 del minimo. minlength da solo non rende obbligatorio il campo. Assegnare .value non attiva questo errore, nemmeno chiamando poi checkValidity() o reportValidity().

Usa valid per controllare lo stato complessivo del campo e gli indicatori di errore per scegliere il messaggio. Convalida nuovamente sul server i dati inviati: la convalida del browser può essere aggirata.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ValidityState example</title>
</head>
<body>
  <label for="email">Email:</label>
  <input id="email" type="email" required minlength="8" autocomplete="off">
  <button type="button">Next</button>

  <script>
    (() => {
      const input = document.getElementById('email');
      const state = input.validity;
      const log = (step) => console.log([
        step, state.valid, state.valueMissing, state.typeMismatch, state.tooShort
      ].join(' '));

      input.value = '';
      log('empty');
      input.value = 'not-an-email';
      log('wrong-format');
      input.value = 'a@b.co';
      log('scripted-short');

      input.value = '';
      input.addEventListener('change', () => log('user-short'), { once: true });
    })();
  </script>
</body>
</html>

Risultato

empty false true false false
wrong-format false false true false
scripted-short true false false false
user-short false false false true

Apri l’esempio come pagina HTML in un browser e controlla l’output nella console del browser. Dopo le prime tre righe, digita `a@b.co` nel campo e premi Tab. Dopo l’etichetta del passaggio compaiono nell’ordine `valid`, `valueMissing`, `typeMismatch` e `tooShort`. Lo stesso indirizzo di sei unità di codice è sintatticamente valido in entrambi i casi, ma viola `minLength = 8` solo dopo l’immissione manuale.

Lezioni correlate

  • JavaScript · Lezione 22 · Intermedio · Versione: 3

Fonti