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