17370845950

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）挂载关联状态，又不想干扰其生命周期。

对比 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 私有字段语法（ES2025+）的老环境，或需要动态生成私有状态时，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 就失效了。