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

CKTIS / JavaScript

Noms des erreurs : Error.prototype.name

La propriété name d’un objet erreur décrit sa catégorie, par exemple Error ou TypeError. Elle peut être remplacée, mais changer le nom ne modifie ni le type de l’objet ni sa chaîne de prototypes.

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

error.name
error.name = "CustomError"

L’intitulé Error.name désigne ici le nom d’une instance d’erreur : on le lit avec error.name. Cette propriété est définie sur Error.prototype avec la valeur initiale "Error". Des types tels que TypeError fournissent leurs propres noms sur leurs prototypes. En revanche, l’expression littérale Error.name lit le nom de la fonction constructeur : il s’agit d’une autre propriété.

name indique la catégorie, tandis que message décrit le problème particulier. Error.prototype.toString() utilise les deux propriétés ; lorsqu’elles sont toutes deux des chaînes non vides, le résultat est "name: message".

Error.prototype.name est modifiable, non énumérable et configurable. Affecter error.name = "ValidationError" à une instance ordinaire crée une propriété propre à cette instance. Cela ne crée pas un nouveau type d’erreur et ne modifie pas la chaîne de prototypes : l’objet vérifie toujours error instanceof Error. Le nom seul ne prouve donc pas le type d’un objet.

Exemples

const error = new Error("Invalid input");
console.log(error.name);
error.name = "ValidationError";
console.log(error.name);
console.log(error.message);
console.log(error.toString());
console.log(error instanceof Error);

Résultat

Error
ValidationError
Invalid input
ValidationError: Invalid input
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