CKTIS / JavaScript
ValidityState : validité globale et motifs d’erreur
Lisez `element.validity` pour distinguer un champ valide d’une valeur obligatoire absente, d’un format incorrect ou d’une saisie utilisateur trop courte.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const state = input.validity;
state.valid;
state.valueMissing;
state.typeMismatch;
state.tooShort;element.validity renvoie un objet ValidityState associé à un champ de formulaire. Ses propriétés booléennes sont en lecture seule et reflètent l’état courant : conserver l’objet ne fige pas ses valeurs. Cette API appartient à la plateforme web, pas à ECMAScript.
valid vaut true uniquement si aucun indicateur d’erreur n’est actif, y compris ceux qui ne sont pas détaillés ici, comme customError. Plusieurs indicateurs peuvent valoir true à la fois. valueMissing vaut true si la valeur imposée par required manque, comme dans un champ d’adresse électronique obligatoire laissé vide.
typeMismatch vaut true lorsqu’une valeur non vide ne respecte pas la syntaxe HTML de type="email" ou type="url". Pour le type e-mail, multiple autorise une liste d’adresses séparées par des virgules. Un champ e-mail obligatoire vide présente valueMissing, pas typeMismatch. Le contrôle de la syntaxe ne prouve pas qu’une adresse existe.
tooShort vaut true si minlength s’applique à un élément input ou textarea, que l’indicateur de modification (dirty value flag) est actif, que la dernière modification de la valeur vient de l’utilisateur et que la valeur non vide exposée par l’API est plus courte que le minimum en unités de code UTF-16. minlength ne rend pas le champ obligatoire. Affecter .value ne déclenche pas cette erreur, même en appelant ensuite checkValidity() ou reportValidity().
Utilisez valid pour connaître l’état global du champ et les indicateurs d’erreur pour choisir le message à afficher. Validez à nouveau les données soumises côté serveur : la validation du navigateur peut être contournée.
Exemples
<!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>Résultat
empty false true false false wrong-format false false true false scripted-short true false false false user-short false false false true
Ouvrez l’exemple en tant que page HTML dans un navigateur et consultez la sortie dans la console du navigateur. Après les trois premières lignes, tapez `a@b.co` dans le champ et appuyez sur Tab. Après le libellé de l’étape, les colonnes sont `valid`, `valueMissing`, `typeMismatch` et `tooShort`. La même adresse de six unités de code est correcte dans les deux cas sur le plan syntaxique, mais ne contrevient à `minLength = 8` qu’après la saisie manuelle.
Leçons associées
- JavaScript · Leçon 22 · Intermédiaire · Version : 3