JavaScript WeakMap是什么_弱引用有何应用场景？-js教程-PHP中文网

weakmap 的键必须是对象且弱引用，不阻止垃圾回收；仅支持 set/get，不可遍历；适用于dom私有数据和类私有字段，但不适用于缓存，且value强引用可能导致循环引用。

javascript weakmap是什么_弱引用有何应用场景？

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 私有字段语法（ES2022+）的老环境，或需要动态生成私有状态时，WeakMap 是轻量可靠的方案。它比闭包更易测试，比 Symbol 属性更彻底（后者仍可被 Object.getOwnPropertySymbols() 枚举）。

ApiPost接口调试与文档生成工具

ApiPost是一个支持团队协作，支持模拟POST、GET、PUT等常见请求，并可直接生成文档的API调试、管理工具，ApiPost是后台接口开发者或前端、接口测试人员的工作必备工具。快速生成、一键导出API文档。感兴趣的朋友快来下载吧。软件说明ApiPost官方版是一款十分出色的接口调试与文档生成工具，ApiPost官方版界面美观大方，功能强劲实用，支持团队协作，支持模拟POST、GET、PUT等常见请求，是后台接口开发者或前端、接口测试人员的工作必备工具。软件特色更方便支持接口调试的同时快速生成、一键

下载

注意：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+）

真正需要弱缓存时，应优先考虑：