CKTIS / JavaScript
HTMLFormElement.checkValidity() — vérifier la validité d’un formulaire
La méthode form.checkValidity() vérifie les contraintes des contrôles associés à un formulaire et renvoie un booléen. Elle ne soumet pas le formulaire et n’affiche pas les messages de validation standard du navigateur.
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
form.checkValidity()HTMLFormElement.checkValidity est une méthode de l’API Web du navigateur, et non une fonction définie par ECMAScript. L’appel form.checkValidity() ne prend aucun argument et renvoie de façon synchrone true si chaque contrôle pouvant être validé respecte ses contraintes ; sinon, il renvoie false.
La vérification porte sur les contrôles associés au formulaire, et pas seulement sur ses descendants. Les contrôles désactivés avec disabled sont ignorés. Si aucun contrôle ne peut être validé, le résultat est true. La méthode déclenche un événement invalid sur chaque contrôle invalide ; annuler cet événement ne transforme pas le résultat en true.
La méthode ne soumet pas le formulaire et n’affiche pas elle-même l’interface d’erreur standard. Utilisez form.reportValidity() pour vérifier les problèmes et les signaler à l’utilisateur. La validation dans le navigateur ne remplace pas la validation côté serveur.
L’exemple crée un formulaire avec un champ texte obligatoire. Le champ vide produit false et un événement invalid ; après l’affectation de Ada, le résultat est true. Exécutez le code dans un navigateur : un environnement Node.js 24, à lui seul, ne permet pas d’établir que cette API est disponible.
Exemples
(() => {
const form = document.createElement('form');
const input = document.createElement('input');
input.required = true;
form.append(input);
let invalidEvents = 0;
input.addEventListener('invalid', () => { invalidEvents += 1; });
console.log(form.checkValidity());
input.value = 'Ada';
console.log(form.checkValidity());
console.log(invalidEvents);
})();Résultat
false true 1
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.