WeakMap 的键必须是对象且弱引用，不阻止垃圾回收；仅支持 set/get，不可遍历；适用于DOM私有数据和类私有字段，但不适用于缓存，且value强引用可能导致循环引用。
WeakMap 的键必须是对象，且不阻止垃圾回收
WeakMap 是 JavaScript 中唯一一种「键不可枚举、键弱引用」的集合类型。它的核心特性不是“值弱引用”，而是 key 必须是对象，且该对象仅被 WeakMap 持有时，会被垃圾回收器立即回收——哪怕 WeakMap 本身还活着。
这直接决定了它不能用 string、number 或 null 当键，也不支持 size、keys()、values()、entries() 等遍历方法。你只能靠已知对象去 get 或 set。
常见错误现象：
-
new WeakMap().set('foo', 1)→ 报错：TypeError: Invalid value used as weak map key -
const wm = new WeakMap(); wm.set(obj, val); obj = null;→ 后续wm.get(obj)返回undefined（因为obj已不可达）
给 DOM 元素绑定私有元数据，不造成内存泄漏
这是 WeakMap 最经典、最不可替代的使用场景：为第三方或无法修改源码的对象（比如用户传入的 HTMLElement）挂载关联状态，又不想干扰其生命周期。
立即学习“Java免费学习笔记（深入）”；
对比 Map 或对象属性：
- 用
element.myPluginData = {...}：污染原型或属性名可能冲突，且手动清理容易遗漏 - 用
Map存储element → data：只要 Map 还持有该元素引用，元素就永远不会被 GC，滚动列表、频繁增删 DOM 时极易泄漏 - 用
WeakMap：DOM 元素被移除后自动解绑，无需任何 cleanup 逻辑
const elementData = new WeakMap();
function attachTooltip(element, text) {
elementData.set(element, { tooltipText: text, shown: false });
}
function showTooltip(element) {
const data = elementData.get(element);
if (data) data.shown = true;
}
// 页面中 element.remove() 后，elementData 自动丢弃对应条目
实现私有实例字段（类内部封装），避开 Symbol 或闭包开销
在没有 #field 私有字段语法（ES2022+）的老环境，或需要动态生成私有状态时，WeakMap 是轻量可靠的方案。它比闭包更易测试，比 Symbol 属性更彻底（后者仍可被 Object.getOwnPropertySymbols() 枚举）。
注意：WeakMap 实例必须定义在模块/类作用域顶层，不能每次构造都新建，否则失去“同一份映射”的意义。
const privateStore = new WeakMap();
class CacheManager {
constructor(options) {
privateStore.set(this, { cache: new Map(), options });
}
getCache() {
return privateStore.get(this).cache;
}
setOption(key, value) {
privateStore.get(this).options[key] = value;
}
}
关键点：
-
privateStore是模块级常量，所有实例共享同一个 WeakMap - 每个实例对象作为 key，确保不同实例数据隔离
- 实例被销毁后，对应缓存数据自然消失，不会堆积
WeakMap 不是 WeakRef，也不能用于缓存策略
WeakMap 常被误认为“弱引用缓存”，但它完全不适合做 LRU、TTL 或防重复计算这类缓存。因为：
- 你无法预知某个 key 何时被回收——GC 触发时机不确定，甚至可能一直不触发
- 没有
iterate能力，无法主动淘汰旧项或统计命中率 -
WeakRef+FinalizationRegistry才是可控的弱引用工具链，但复杂度高、兼容性差（Node.js 14.6+ / Chrome 84+）
真正需要弱缓存时，应优先考虑：
- 明确生命周期的显式管理（如监听
unload、disconnect） - 带 TTL 的 Map + 定时清理
- 仅在确定对象会短期存在、且必须避免强引用时，才用 WeakMap
最容易被忽略的一点：WeakMap 的“弱”只作用于 key，value 仍是强引用。如果 value 里又持有 key（比如闭包中引用了 this），就会形成循环引用，导致 key 无法被回收——这时 WeakMap 就失效了。
