Symbol 是 JavaScript 的原始类型,用于创建唯一不可变标识符;它解决属性名冲突、支持全局注册表(Symbol.for)、启用内置协议(如 Symbol.iterator),但非真正私有。
它不是字符串,也不是对象,而是一种全新的原始类型(和 string、number 并列)。每次调用 Symbol() 都会返回一个**全新且不相等**的值,哪怕描述相同:
Symbol(这种天然唯一性,让它成为解决「属性名冲突」和「私有属性模拟」问题的核心工具。'foo') === Symbol('foo') // false
在没有 Symbol 之前,多人协作或引入第三方库时,很容易因使用相同字符串键名导致覆盖。比如两个模块都往 obj 上加 id 或 cache 字段,谁后写谁赢。
用 Symbol 就能隔离:
const CACHE_KEY = Symbol('cache');
const ID_KEY = Symbol('id');
obj[CACHE_KEY] = new Map();
obj[ID_KEY] = 123;
// 其他代码无法通过字符串 'cache' 访问到它,也不会被覆盖Symbol 属性不会出现在 for...in、Object.keys()、JSON.stringify() 中,但可通过 Object.getOwnPropertySymbols() 获取。
普通 Symbol() 每次都新造,但有时需要跨模块共享同一个 Symbol —— 这就得用全局注册表:
Symbol.for('myKey') 会先查全局池,存在就返回,否则新建并登记Symbol.keyFor(sym) 可反查该 Symbol 是否来自注册表及其键名Symbol.for('a') !== Symbol('a'),后者是匿名独立 SymbolSymbol.for('react.element'))时很关键。
JavaScript 引擎会识别特定名称的 Symbol 属性,赋予对象语言级能力。最典型的是:
[Symbol.iterator]:让对象可用 for...of 遍历[Symbol.toStringTag]:影响 Object.prototype.toString.call(obj) 输出[Symbol.hasInstance]:定制 instanceof 行为真正容易忽略的是:Symbol 属性虽“隐藏”,但并非真正私有 —— 它仍可被 Object.getOwnPropertySymbols() 或 Reflect.ownKeys() 暴露。如果真要封装,得配合闭包或 WeakMap;Symbol 更适合做「防误撞」而非「防访问」。