此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
Symbol.toStringTag
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2017年4月.
Symbol.toStringTag 内置通用（well-known）symbol 是一个字符串值属性，用于创建对象的默认字符串描述。它由Object.prototype.toString() 方法内部访问。
尝试一下
class ValidatorClass { get [Symbol.toStringTag]() { return "Validator"; }}console.log(Object.prototype.toString.call(new ValidatorClass()));// Expected output: "[object Validator]"Symbol.toStringTag 的属性特性 | |
|---|---|
| 可写 | 否 |
| 可枚举 | 否 |
| 可配置 | 否 |
示例
默认标签
一些值没有Symbol.toStringTag，但是有额外的toString() 表示。有关完整列表，请参见Object.prototype.toString()。
js
Object.prototype.toString.call("foo"); // "[object String]"Object.prototype.toString.call([1, 2]); // "[object Array]"Object.prototype.toString.call(3); // "[object Number]"Object.prototype.toString.call(true); // "[object Boolean]"Object.prototype.toString.call(undefined); // "[object Undefined]"Object.prototype.toString.call(null); // "[object Null]"// ... and more内置的 toStringTag symbol
大多数内置的对象提供了它们自己的[Symbol.toStringTag] 属性。所有内置对象的[Symbol.toStringTag] 属性都是不可写的（writable）、不可枚举的（enumerable）但是可配置的（configurable）。
js
Object.prototype.toString.call(new Map()); // "[object Map]"Object.prototype.toString.call(function* () {}); // "[object GeneratorFunction]"Object.prototype.toString.call(Promise.resolve()); // "[object Promise]"// ... and more使用 toStringTag 自定义标签
当创建你自己的类时，JavaScript 默认用“Object”标签：
js
class ValidatorClass {}Object.prototype.toString.call(new ValidatorClass()); // "[object Object]"现在，在toStringTag 的帮助下，你可以设置自己的自定义标签：
js
class ValidatorClass { get [Symbol.toStringTag]() { return "Validator"; }}Object.prototype.toString.call(new ValidatorClass()); // "[object Validator]"toStringTag 适用于所有 DOM 原型对象
由于 2020 年年中WebIDL 规范的变化，浏览器正在向所有 DOM 原型对象添加Symbol.toStringTag 属性。例如，要访问HTMLButtonElement 上的Symbol.toStringTag 属性：
js
const test = document.createElement("button");test.toString(); // Returns [object HTMLButtonElement]test[Symbol.toStringTag]; // Returns HTMLButtonElement规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-symbol.tostringtag |