CKTIS / JavaScript
HTMLInputElement.setCustomValidity — une erreur de validation personnalisée
HTMLInputElement.setCustomValidity définit ou efface l’erreur personnalisée d’un champ de formulaire. Une chaîne vide efface cette erreur sans désactiver les autres contraintes.
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.setCustomValidity(message)HTMLInputElement.setCustomValidity est une méthode de l’API de validation des formulaires du navigateur, 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 ne prouve pas que cette API est disponible.
Appeler input.setCustomValidity(message) avec une chaîne non vide définit input.validity.customError sur true. Passer "" efface uniquement l’erreur personnalisée : les contraintes comme required restent applicables. La méthode renvoie undefined, et non un résultat de validation.
La méthode n’affiche pas elle-même de message. checkValidity() vérifie la validité sans afficher de message d’erreur. Si le champ échoue à la validation, reportValidity() renvoie false, et le navigateur ne signale le problème à l’utilisateur que si l’événement invalid n’est pas annulé. L’annulation de l’événement ne change pas la valeur renvoyée. Les éléments exclus de la validation peuvent conserver une erreur personnalisée même s’ils n’empêchent pas l’envoi validé d’un formulaire.
Après une modification de valeur, réévaluez la règle et effacez explicitement toute erreur obsolète, généralement dans un gestionnaire d’événement input. Dans l’exemple, le dernier false false signifie qu’il n’y a pas d’erreur personnalisée, mais que required n’est pas satisfait. La validation côté client ne remplace pas la validation côté serveur.
Exemples
const input = document.createElement("input");
input.required = true;
input.value = "admin";
function validate() {
input.setCustomValidity(
input.value === "admin" ? "Reserved name." : ""
);
}
validate();
console.log(input.validity.customError, input.checkValidity());
input.value = "alex";
validate();
console.log(input.validity.customError, input.checkValidity());
input.value = "";
validate();
console.log(input.validity.customError, input.checkValidity());Résultat
true false false true false false
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.