Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.valueMissing

HTMLInputElement.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.

Sources