CKTIS / JavaScript
HTMLFormElement.reportValidity() — valider un formulaire et signaler les erreurs
HTMLFormElement.reportValidity() vérifie les contraintes de validation des contrôles associés à un formulaire et peut signaler les erreurs à l’utilisateur. La méthode renvoie un booléen et ne soumet pas le formulaire elle-même.
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.reportValidity()HTMLFormElement.reportValidity est une méthode de l’interface des formulaires définie par le HTML Living Standard, et non par ECMAScript. L’appel form.reportValidity() ne prend aucun argument et renvoie synchroniquement true si tous les contrôles soumis à validation sont valides, ou false si au moins l’un d’eux ne l’est pas.
La méthode lance la validation interactive des contraintes, telles que required. Elle déclenche des événements invalid sur les contrôles invalides. Le navigateur peut signaler les erreurs dont le traitement n’a pas été annulé ; l’apparence et le texte des messages dépendent du navigateur. Appeler event.preventDefault() dans un gestionnaire invalid supprime le signalement natif de cette erreur, sans modifier le résultat false.
Contrairement à reportValidity(), checkValidity() vérifie les contraintes sans signalement interactif des erreurs, mais déclenche également invalid. Aucune de ces méthodes ne soumet le formulaire. Les contrôles désactivés avec disabled sont exclus de la validation ; la validation côté client ne remplace pas la vérification des données côté serveur.
Il s’agit d’une API de navigateur : la présence de Node 24 ne garantit pas sa disponibilité. Dans l’environnement cible, vérifiez typeof HTMLFormElement !== 'undefined' && typeof HTMLFormElement.prototype.reportValidity === 'function'. L’exemple annule volontairement invalid afin de vérifier les résultats booléens sans dépendre de l’interface des messages de validation.
Exemples
(() => {
const form = document.createElement('form');
const input = document.createElement('input');
input.required = true;
input.setAttribute('aria-label', 'Name');
form.append(input);
document.body.append(form);
// Suppress native validation UI for deterministic console checks.
input.addEventListener('invalid', event => event.preventDefault());
console.log(form.reportValidity());
input.value = 'Ada';
console.log(form.reportValidity());
form.remove();
})();Résultat
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.