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

CKTIS / JavaScript

ValidityState — état de validation d’un champ de formulaire

ValidityState expose des indicateurs d’erreur en lecture seule pour un champ de formulaire. Il permet de distinguer une valeur obligatoire manquante, un format invalide et un texte trop court, avec une exception importante pour les valeurs définies par des scripts.

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

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

ValidityState est une interface de l’API Web HTML, et non une partie d’ECMAScript. L’objet accessible via input.validity est mis à jour en temps réel ; ses indicateurs booléens sont en lecture seule. ValidityState.valid vaut true lorsqu’aucun des autres indicateurs d’erreur n’est activé.

ValidityState.valueMissing signale qu’une contrainte required n’est pas satisfaite : pour un champ texte, cela signifie que la valeur est vide. ValidityState.typeMismatch signifie qu’une valeur ne respecte pas les règles du type email ou url, et non celles d’un type de données JavaScript. Une adresse e-mail vide ne provoque pas cette erreur à elle seule.

ValidityState.tooShort concerne une valeur non vide plus courte que minlength dans un champ qui prend en charge cette contrainte. Le drapeau dirty value doit être activé et la dernière modification de la valeur doit provenir d’une saisie de l’utilisateur. Affecter une valeur à .value ne déclenche pas ce contrôle de longueur ; minlength seul n’impose pas de saisir une valeur.

L’exemple conserve un seul objet d’état et le lit après les modifications. Pour 'x', tooShort reste à false, car la valeur est définie par un script. Exécutez-le dans un navigateur ; la présence de Node 24 dans le dépôt ne démontre pas la prise en charge de cette API.

Exemples

(() => {
  const input = document.createElement('input');
  input.type = 'email';
  input.required = true;
  input.minLength = 8;
  const state = input.validity;

  const show = () => console.log(JSON.stringify({
    valid: state.valid,
    valueMissing: state.valueMissing,
    typeMismatch: state.typeMismatch,
    tooShort: state.tooShort
  }));

  show();
  input.value = 'x';
  show();
  input.value = 'a@example.com';
  show();
})();

Résultat

{"valid":false,"valueMissing":true,"typeMismatch":false,"tooShort":false}
{"valid":false,"valueMissing":false,"typeMismatch":true,"tooShort":false}
{"valid":true,"valueMissing":false,"typeMismatch":false,"tooShort":false}

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