为什么 WeakMap 的键不能是基本类型?
参考答案
结论
WeakMap 的键必须是对象(或非注册 Symbol),不能是 string/number/boolean/null/undefined/bigint 这类原始值。
原因
- 弱引用需要"可被 GC 追踪的对象标识":WeakMap 的语义是"键对象被回收后自动删除条目"。原始值(如
1、'a')是值语义、不可被 GC 单独追踪、也没有稳定的对象身份,无法建立弱引用。 - 原始值不可回收,弱引用语义无意义:数字
1永远存在,若允许作键,条目就永远无法自动清理,WeakMap 就退化成一个无法遍历、无法统计的"残废 Map"。 - 不可枚举的实现基础:WeakMap 需要依赖对象的生命周期做隐藏存储(引擎内部用弱表),原始值没有生命周期。
- 避免歧义:若允许原始值,
map.set(1, x)中"1"是哪个 1?不同来源的相同数值无法区分身份。
允许的键
- 对象(含函数、数组、DOM 节点、类实例)。
- 非注册的 Symbol(
Symbol(),ES2023 起允许);Symbol.for()注册 Symbol 不允许(因为它在全局注册表中永存,弱引用无意义)。
对比 Map
const m = new Map();
m.set('a', 1); // ✅ Map 允许原始值键
m.set(NaN, 2); // ✅
const wm = new WeakMap();
wm.set('a', 1); // ❌ TypeError: Invalid value used as weak map key
实践含义
- 需要以字符串/数字为键 → 用
Map(或对象)。 - 需要"随对象生命周期自动清理的附加数据" → 用
WeakMap,键必须是那个对象。 - 想给原始值做缓存 → 用
Map并自己做 LRU/上限,不能指望自动回收。
一句话
WeakMap 的"弱"建立在对对象生命周期的观察上,原始值没有对象身份与生命周期,所以不能当键。