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

CKTIS / JavaScript

HTMLInputElement.checkValidity() — vérifier la validité d’un champ

La méthode checkValidity() vérifie les contraintes d’un seul champ input et renvoie un booléen. Si le champ est invalide et participe à la validation, elle déclenche invalid, mais n’affiche pas elle-même de message d’erreur.

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

input.checkValidity()

HTMLInputElement.checkValidity est une méthode d’instance appelée sans argument sous la forme input.checkValidity(). Elle renvoie false si le champ participe à la validation et enfreint ses contraintes ; sinon, elle renvoie true.

Les contraintes dépendent du type de champ et d’attributs tels que required, pattern, min et max. Un champ disabled ne participe pas à la validation : true ne signifie donc pas nécessairement que sa valeur est valide. La propriété willValidate indique si le champ y participe.

Lorsque le résultat est false, la méthode déclenche un événement invalid ; l’annuler ne change pas le résultat. Contrairement à reportValidity(), elle n’affiche pas de message d’erreur. Elle ne soumet pas le formulaire et ne vérifie pas les autres champs.

Cette API de navigateur est définie par le HTML Living Standard, et non par ECMAScript. Elle est prise en charge par les moteurs de navigateur actuels ; la présence de Node 24 dans un dépôt ne prouve pas que cette API est prise en charge.

Exemples

const input = document.createElement('input');
input.type = 'text';
input.required = true;
let invalidEvents = 0;
input.addEventListener('invalid', () => { invalidEvents += 1; });

console.log(input.checkValidity());
input.value = 'Ada';
console.log(input.checkValidity());
input.value = '';
input.disabled = true;
console.log(input.checkValidity());
console.log(invalidEvents);

Résultat

false
true
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.

Sources