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; } }关键点：
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 就失效了。