17370845950

Symbol是JavaScript第七种原始类型，唯一且不可变；每次调用Symbol()返回新值，即使描述相同也不相等；不可用new调用，不支持自动装箱；主要用作对象属性键避免命名冲突，Object.keys()等忽略Symbol键，但可通过Object.getOwnPropertySymbols()获取。

Symbol 是唯一且不可变的原始值

Symbol 是 JavaScript 中第七种原始类型（其余为 string、number、boolean、null、undefined、bigint），每次调用 Symbol() 都会返回一个**全新且不相等**的值，哪怕描述相同：

const s1 = Symbol('foo');
const s2 = Symbol('foo');
console.log(s1 === s2); // false

它不能用 new 调用，也不支持自动装箱（没有对应的包装对象），所以 typeof new Symbol() 会直接报错。它的“唯一性”不是靠全局注册表保证的，而是语言层面的强制行为——这正是它最核心的特性。

用作对象属性键，避免命名冲突

Symbol 最常见的用途是作为对象的属性键，尤其适合库作者或框架内部添加私有/非侵入字段，不干扰用户自有属性：

• Object.keys()、JSON.stringify()、for...in 都**忽略 Symbol 键**
• 但可通过 Object.getOwnPropertySymbols() 显式获取
• 注意：Reflect.ownKeys() 会同时返回字符串键和 Symbol 键

例如，给数组添加自定义迭代行为而不污染原生方法：

立即学习“Java免费学习笔记（深入）”；

const myIterator = Symbol('myIterator');
const arr = [1, 2, 3];
arr[myIterator] = function* () {
  yield* this.values();
};
// 外部代码不会意外覆盖或遍历到 myIterator

全局 Symbol 注册表：Symbol.for() 和 Symbol.keyFor()

普通 Symbol() 每次都新建，而 Symbol.for(key) 会在全局注册表中查找并复用已存在的 Symbol（按字符串 key 匹配）：

const s1 = Symbol.for('shared');
const s2 = Symbol.for('shared');
console.log(s1 === s2); // true
console.log(Symbol.keyFor(s1)); // 'shared'

这个机制适用于跨模块共享 Symbol，比如不同包想约定同一个元数据标识符。但要注意：Symbol.for() 返回的 Symbol 仍能被 Object.getOwnPropertySymbols() 获取，它只是“可复用”，并非“私有”。

内置 Symbol：影响对象底层行为

JavaScript 预定义了一批以 Symbol. 开头的特殊 Symbol，用于定制对象在特定场景下的行为。它们不是语法糖，而是引擎直接识别的钩子：

• Symbol.iterator：让对象可被 for...of 遍历
• Symbol.toStringTag：影响 Object.prototype.toString.call(obj) 的返回值
• Symbol.hasInstance：改变 instanceof 的判断逻辑
• Symbol.toPrimitive：控制对象转原始值（如 +obj、`${obj}`）时的行为

这些 Symbol 必须作为对象自身的属性（不能只在原型链上），且值必须是函数（除 toStringTag 外）。例如：

const obj = {
  [Symbol.toStringTag]: 'MyClass'
};
console.log(Object.prototype.toString.call(obj)); // '[object MyClass]'

真正容易被忽略的是：这些 Symbol 属性默认不会出现在 Object.keys() 或 JSON.stringify() 中，但会被部分反射 API（如 getOwnPropertyDescriptor）捕获——这意味着调试时可能看不到它们，却实际影响运行时行为。