CKTIS / JavaScript
Error.message — le texte du message d’erreur
La propriété message d’une instance Error contient le texte du message, sans le nom de l’erreur. Découvrez la différence entre error.message et error.toString(), ainsi que le comportement lorsque le message est omis.
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
const error = new Error(message);
error.messageError.message désigne ici la propriété message d’une instance d’erreur, accessible avec error.message, et non une propriété statique du constructeur Error. Elle fait partie d’ECMAScript, pas d’une API Web.
Lorsqu’on appelle new Error(message) avec un argument différent de undefined, le constructeur applique l’opération ToString. Ce n’est que si la conversion réussit qu’il stocke le résultat dans une propriété message propre, non énumérable, modifiable et configurable. Par exemple, new Error(Symbol()) lève une exception TypeError lors de la conversion : l’appel ne renvoie donc pas d’instance. Si l’argument est omis ou vaut undefined, le constructeur ne crée pas de propriété message propre ; si le prototype n’a pas été modifié, sa lecture renvoie la propriété héritée Error.prototype.message, dont la valeur initiale est la chaîne vide "".
error.message contient uniquement le message. En revanche, pour un Error ordinaire avec un message non vide, error.toString() associe le nom et le message sous la forme Error: Invalid input. Lorsque le message est vide, il renvoie uniquement le nom Error.
Pour obtenir des exemples prévisibles, fournissez votre propre message, comme ci-dessous. Ne fondez pas la logique de votre programme sur la formulation exacte des messages générés par le moteur : leur texte peut varier selon les implémentations.
Exemples
const error = new Error("Invalid input");
console.log(error.message);
console.log(error.toString());
console.log(JSON.stringify(new Error().message));Résultat
Invalid input Error: Invalid input ""
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.