La méthode toString()
renvoie une représentation de l'objet Error
sous la forme d'une chaine de caractères.
Syntaxe
e.toString()
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 (en partant du principe que Object
et String
ont leurs valeurs originales) :
Error.prototype.toString = function () { "use strict"; var obj = Object(this); if (obj !== this) throw new TypeError(); var name = this.name; name = (name === undefined) ? "Error" : String(name); var msg = this.message; msg = (msg === undefined) ? "" : String(msg); if (name === "") return msg; if (msg === "") return name; return name + ": " + msg; };
Exemples
var e = new Error("Erreur fatale"); console.log(e.toString()); // "Error: Erreur fatale" e.name = undefined; console.log(e.toString()); // "Error: Erreur fatale" e.name = ""; console.log(e.toString()); // "Erreur fatale" e.message = undefined; console.log(e.toString()); // "Error" e.name = "salut"; console.log(e.toString()); // "salut"
Spécifications
Spécification | État | Commentaires |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Définition initiale. Implémentée avec JavaScript 1.1. |
ECMAScript 5.1 (ECMA-262) La définition de 'Error.prototype.toString' dans cette spécification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) La définition de 'Error.prototype.toString' dans cette spécification. |
Standard | |
ECMAScript 2017 Draft (ECMA-262) La définition de 'Error.prototype.toString' dans cette spécification. |
Projet |
Compatibilité des navigateurs
Fonctionnalité | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Support simple | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) |
Fonctionnalité | Android | Chrome pour Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Support simple | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) | (Oui) |