Error.prototype.toString()

基线广泛可用

自 2015年7月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

Error 实例的 toString() 方法返回一个表示此错误的字符串。

本文内容

语法

toString()

参数

无。

返回值

一个表示指定 Error 对象的字符串。

描述

Error 对象重写了所有对象继承的 Object.prototype.toString() 方法。其语义如下：

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}`;
};

示例

使用 toString()

js
const e1 = new Error("致命错误");
console.log(e1.toString()); // "Error: 致命错误"

const e2 = new Error("致命错误");
e2.name = undefined;
console.log(e2.toString()); // "Error: 致命错误"

const e3 = new Error("致命错误");
e3.name = "";
console.log(e3.toString()); // "致命错误"

const e4 = new Error("致命错误");
e4.name = "";
e4.message = undefined;
console.log(e4.toString()); // ""

const e5 = new Error("致命错误");
e5.name = "你好";
e5.message = undefined;
console.log(e5.toString()); // "你好"

规范

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

浏览器兼容性

启用 JavaScript 以查看此浏览器兼容性表。

参见

core-js 中 Error.prototype.toString 的 polyfill（修复了多个错误）

帮助改进 MDN

此页面对您有帮助吗？

是否

了解如何参与贡献

此页面最后更新于 2025年10月23日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题

JavaScript 标准内置对象
Error
构造函数
1. Error() 构造函数
静态方法
1. captureStackTrace()
2. isError()
静态属性
1. stackTraceLimit
实例方法
1. Error.prototype.toString()
实例属性
1. Error: cause
2. Error.prototype.columnNumber
3. Error.prototype.fileName
4. Error.prototype.lineNumber
5. Error: message
6. Error.prototype.name
7. Error.prototype.stack
继承
Object/Function
静态方法
1. Function.prototype.apply()
2. Function.prototype.bind()
3. Function.prototype.call()
4. Function.prototype.toString()
5. Function.prototype[Symbol.hasInstance]()
静态属性
1. Function.displayName
2. Function：length
3. Function.name
4. Function.prototype.prototype
5. Function.prototype.arguments
6. Function.prototype.caller
实例方法
1. Object.prototype.__defineGetter__()
2. Object.prototype.__defineSetter__()
3. Object.prototype.__lookupGetter__()
4. Object.prototype.__lookupSetter__()
5. Object.prototype.hasOwnProperty()
6. Object.prototype.isPrototypeOf()
7. Object.prototype.propertyIsEnumerable()
8. Object.prototype.toLocaleString()
9. Object.prototype.toString()
10. Object.prototype.valueOf()
实例属性
1. Object.prototype.__proto__
2. Object.prototype.constructor
相关页面
AggregateError
EvalError
InternalError
RangeError
ReferenceError
SyntaxError
TypeError
URIError