Error : méthode toString() - JavaScript | MDN

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

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

Compatibilité des navigateurs

Voir aussi

Help improve MDN

Learn how to contribute

Cette page a été modifiée le par les contributeurs du MDN.