CKTIS / JavaScript
HTMLInputElement.validity — état de validité d’un champ de saisie
HTMLInputElement.validity expose l’état actuel de validation des contraintes d’un champ de saisie sous la forme d’un objet ValidityState. Ses indicateurs signalent des problèmes précis, tandis que valid indique qu’aucun indicateur d’erreur n’est activé.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
input.validity
input.validity.valid
input.validity.valueMissingHTMLInputElement.validity est une propriété en lecture seule qui renvoie un objet ValidityState vivant : une référence conservée reflète les modifications ultérieures du champ. Ses indicateurs sont eux aussi en lecture seule. Cette API de navigateur est définie par HTML, et non par ECMAScript ; la seule disponibilité de Node.js ne garantit pas sa prise en charge.
valueMissing signale l’absence d’une valeur requise, typeMismatch un format incompatible avec le type, et patternMismatch une incompatibilité avec pattern. Les autres indicateurs d’erreur sont tooLong, tooShort, rangeUnderflow, rangeOverflow, stepMismatch, badInput et customError. Leur applicabilité dépend du type de champ et des contraintes. valid vaut true lorsque tous les indicateurs d’erreur valent false.
Lire validity n’affiche aucun message et ne déclenche pas invalid. checkValidity() vérifie le contrôle et peut déclencher invalid ; reportValidity() peut aussi présenter le problème à l’utilisateur. willValidate détermine la participation à la validation : un champ désactivé peut toujours avoir des indicateurs d’erreur même s’il ne participe pas à la vérification.
setCustomValidity('Blocked') définit customError ; effacez-le avec setCustomValidity(''). Corriger la valeur ne suffit pas à effacer l’erreur. L’exemple montre les mises à jour via l’objet state conservé, sans relire input.validity. La validation du navigateur ne remplace pas la vérification des données côté serveur.
Exemples
const input = document.createElement('input');
input.type = 'email';
input.required = true;
const state = input.validity;
console.log(state.valueMissing, state.valid);
input.value = 'learner@example.com';
console.log(state.valueMissing, state.valid);
input.setCustomValidity('Blocked');
console.log(state.customError, state.valid);
input.setCustomValidity('');
console.log(state.customError, state.valid);Résultat
true false false true true false false true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.