Error.prototype.toString()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

We'd love to hear more about your role and the company you work for
Please help us by answering a few questions.

Die toString()-Methode von Error-Instanzen gibt einen String zurück, der diesen Fehler darstellt.

Syntax

js
toString()

Parameter

Keine.

Rückgabewert

Ein String, der das angegebene Error-Objekt darstellt.

Beschreibung

Das Error-Objekt überschreibt die geerbte Methode Object.prototype.toString(), die von allen Objekten geerbt wird. Seine Semantik ist wie folgt:

js
Error.prototype.toString = function () {
  if (
    this === null ||
    (typeof this !== "object" && typeof this !== "function")
  ) {
    throw new TypeError();
  }
  let name = this.name;
  name = name === undefined ? "Error" : `${name}`;
  let msg = this.message;
  msg = msg === undefined ? "" : `${msg}`;
  if (name === "") {
    return msg;
  }
  if (msg === "") {
    return name;
  }
  return `${name}: ${msg}`;
};

Beispiele

Verwendung von toString()

js
const e1 = new Error("fatal error");
console.log(e1.toString()); // "Error: fatal error"

const e2 = new Error("fatal error");
e2.name = undefined;
console.log(e2.toString()); // "Error: fatal error"

const e3 = new Error("fatal error");
e3.name = "";
console.log(e3.toString()); // "fatal error"

const e4 = new Error("fatal error");
e4.name = "";
e4.message = undefined;
console.log(e4.toString()); // ""

const e5 = new Error("fatal error");
e5.name = "hello";
e5.message = undefined;
console.log(e5.toString()); // "hello"

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-error.prototype.tostring

Browser-Kompatibilität

Siehe auch