Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLFormElement : méthode checkValidity()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

La méthode checkValidity() de l'interface HTMLFormElement retourne une valeur booléenne qui indique si tous les contrôles associés respectent les règles de validation des contraintes qui leur sont appliquées. La méthode déclenche également un évènement annulable invalid sur chaque élément invalide, mais pas sur l'élément de formulaire lui‑même. Comme il n'existe pas de comportement navigateur par défaut pour checkValidity(), annuler cet évènement invalid n'a aucun effet.

Note : Les pseudo-classes CSS :valid et :invalid sont appliquées aux éléments <form> en fonction de la validité de leurs contrôles de formulaire propriétaires, et non de la validité de l'élément <form> lui‑même.

Syntaxe

js
checkValidity()

Paramètres

Aucun.

Valeur de retour

Retourne true si les valeurs des contrôles associés ne présentent aucun problème de validité ; sinon, retourne false.

Exemples

Dans l'exemple suivant, l'appel à checkValidity() renverra true ou false selon la validité des contrôles.

js
const element = document.getElementById("myForm");
console.log(element.checkValidity());

Spécifications

Specification
HTML
# dom-form-checkvalidity-dev

Compatibilité des navigateurs

Voir aussi