怎样利用 Symbol.toStringTag 自定义原始对象在调试器中显示的类标签名

Symbol.toStringTag 是一个内置的 Symbol 值，用于自定义对象在调用 Object.prototype.toString() 时返回的类名标签，同时能影响调试器中的类型显示。开发者可直接赋值、通过原型或类 getter 定义，甚至利用 Proxy 实现动态标签，且不影响 instanceof 或 typeof 的判断。

Symbol.toStringTag 是一个内置 symbol，用于指定对象在调用 Object.prototype.toString() 时返回字符串中的类名部分（即方括号内的名称）。它对调试器（如 Chrome DevTools、VS Code 调试面板）中对象的显示标签有直接影响——许多现代调试器会读取该属性，将其作为对象的“类型标识”展示在变量面板或控制台中。

设置 toStringTag 让自定义对象显示为期望的类名

只需在对象上定义一个 toStringTag 属性，值为字符串即可。该属性需是可枚举的（默认不可枚举），但调试器通常仍能读取（因其通过内部协议访问，不依赖 for...in 或 Object.keys）。

1. 对普通对象：直接赋值 obj[Symbol.toStringTag] = 'MyType'
2. 对构造函数实例：推荐在原型上设置，确保所有实例统一显示
3. 对类：可在类体中使用 getter 定义，更符合面向对象习惯

例如：

class Point {
  constructor(x, y) { this.x = x; this.y = y; }
  get [Symbol.toStringTag]() { return 'Point'; }
}
const p = new Point(1, 2);
console.log(p.toString()); // "[object Point]"
// 在 Chrome 控制台打印 p，左侧会显示 "Point" 标签

原始类型包装对象与 toStringTag 的限制

注意：不能直接给原始值（如字符串字面量、数字）设置 toStringTag，因为它们不是对象。但可以给其包装对象（如 new String('hello')）设置：

1. const s = new String('hello'); s[Symbol.toStringTag] = 'CustomStr'; console.log(s.toString()); // "[object CustomStr]"
2. 不过，日常开发中极少手动创建包装对象；更实用的是在自定义类或 Proxy 中使用
3. 原生类型（String、Number 等）自身已内置 toStringTag，修改其原型会影响全局行为，不推荐

配合 Proxy 实现动态类型标签

若需根据状态动态改变调试显示名，可用 Proxy 拦截 get，让 [Symbol.toStringTag] 返回计算后的字符串：

const createLabeledArray = (label) =>
  new Proxy([], {
    get(target, prop) {
      if (prop === Symbol.toStringTag) return label;
      return Reflect.get(target, prop);
    }
  });

const todos = createLabeledArray('TodoList');
console.log(todos.toString()); // "[object TodoList]"
// DevTools 中展开该数组，顶部会显示 "TodoList"

调试器兼容性与注意事项

1. 主流调试器（Chrome、Edge、VS Code、Firefox）均支持 toStringTag，但旧版 Firefox 可能仅在 console.log 中有效。
2. 它不影响 instanceof 或 typeof，仅用于优化调试显示。
3. 命名时避免空格和特殊符号，调试器空间有限。
4. 若同时存在 constructor.name，两者互不干扰：toStringTag 控制 [object XXX]，constructor.name 影响 obj.constructor.name。