Error : méthode toString()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode toString() des instances de Error retourne une chaîne de caractères représentant cette erreur.
Syntaxe
js
toString()
Paramètres
Aucun.
Valeur de retour
Une chaîne de caractères représentant l'objet Error.
Description
L'objet Error surcharge la méthode Object.prototype.toString() héritée par tous les objets. Sa sémantique est la suivante :
js
Error.prototype.toString = function () {
if (
this === null ||
(typeof this !== "object" && typeof this !== "function")
) {
throw new TypeError();
}
let name = this.name;
name = name === undefined ? "Erreur" : `${name}`;
let msg = this.message;
msg = msg === undefined ? "" : `${msg}`;
if (name === "") {
return msg;
}
if (msg === "") {
return name;
}
return `${name} : ${msg}`;
};
Exemples
Utiliser la méthode toString()
js
const e1 = new Error("erreur fatale");
console.log(e1.toString()); // "Error: erreur fatale"
const e2 = new Error("erreur fatale");
e2.name = undefined;
console.log(e2.toString()); // "Error: erreur fatale"
const e3 = new Error("erreur fatale");
e3.name = "";
console.log(e3.toString()); // "erreur fatale"
const e4 = new Error("erreur fatale");
e4.name = "";
e4.message = undefined;
console.log(e4.toString()); // ""
const e5 = new Error("erreur fatale");
e5.name = "bonjour";
e5.message = undefined;
console.log(e5.toString()); // "bonjour"
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-error.prototype.tostring |