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

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.

Sources