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

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.

Sources