WeakMap 是唯一能将数据“悄悄挂载”到对象上且不阻止其被垃圾回收的工具,专治内存泄漏;键必须为对象,因GC只跟踪对象生命周期,原始值会报错。

WeakMap 不是“弱化的 Map”,而是 JavaScript 中唯一能「把数据悄悄挂到对象上,又不拖住它不许销毁」的工具。
它解决的不是功能缺失问题,而是内存泄漏这个静默杀手——尤其在长期运行的单页应用、频繁操作 DOM 的场景里,一个没清理的 Map 就可能让成百上千个已移除的节点永远卡在内存里。
WeakMap 的键为什么必须是对象?原始值会报错
因为弱引用只对对象有效。JavaScript 的垃圾回收器(GC)只管理对象的生命周期,对字符串、数字这些原始值根本不“记账”。WeakMap 的设计前提就是:键得是 GC 能识别、能跟踪、能决定是否回收的东西。
所以一旦你写:
立即学习“Java免费学习笔记(深入)”;
const wm = new WeakMap();
wm.set('hello', 'world'); // TypeError: Invalid value used as weak map key就会立刻报错。这不是限制,是强制你思考:这个键是不是真需要被“弱关联”?如果不是对象,那它本就不该进 WeakMap。
- 合法键类型:
{}、document.getElementById('x')、new Date()、function() {}、[] - 非法键类型:
'str'、42、true、null、undefined
给 DOM 元素存状态,为什么不用 dataset 或属性?
用 element.myState = {...} 看似简单,但污染了元素自身属性,可能和未来标准属性冲突;用 dataset 只支持字符串,还得手动序列化反序列化;而用 Symbol 属性虽私有,仍可被 Object.getOwnPropertySymbols() 枚举出来,测试或调试时暴露无遗。
WeakMap 是真正“不可见”的挂载方式:
const elementState = new WeakMap();const el = document.querySelector('.card'); elementState.set(el, { expanded: true, lastClick: Date.now() });
// 页面中移除 el 后,只要没其他变量引用它,el 和对应状态自动消失 el.remove(); // 此后 elementState.has(el) → false(即使 el 变量还存在,但对象已无强引用)
关键点:
大高朋团购系统是一套Groupon模式的开源团购程序,开发的一套网团购程序,系统采用ASP+ACCESS开发的团购程序,安装超简,功能超全面,在保留大高朋团购系统版权的前提下,允许所有用户免费使用。大高朋团购系统内置多种主流在线支付接口,所有网银用户均可无障碍支付;短信发送团购券和实物团购快递发货等。 二、为什么选择大高朋团购程序系统? 1.功能强大、细节完善 除了拥有主流团购网站功能,更特别支
- 不依赖 DOM 树存在与否,只依赖对象是否还有外部强引用
- 无法通过
for...in、Object.keys()、JSON.stringify()触达,天然防误读 - 没有
size、不能clear()、不可遍历——不是缺陷,是防止你把它当通用容器滥用
模拟类私有字段时,WeakMap 和 # 语法有什么区别?
ES2022+ 支持 #privateField 语法,写起来更简洁。但 WeakMap 仍有不可替代的场景:
- 你需要兼容旧环境(如 IE 或部分 Node.js 版本)
- 你想把私有数据跨多个类共享(比如基类和子类共用一份元数据)
- 你传入的对象不是你创建的(比如用户传来的
HTMLElement或第三方库实例),没法加#字段
示例:为任意对象附加仅内部可用的缓存
const _cache = new WeakMap();class Renderer { render(obj) { if (!_cache.has(obj)) { _cache.set(obj, this.expensiveTransform(obj)); } return _cache.get(obj); } }
这里 obj 可以是任何对象,甚至是你无法修改原型的第三方实例。一旦它被丢弃,缓存条目自动失效,不用 try/catch 或定时清理。
WeakMap 为什么不适合做通用缓存?
因为它不保证键存在——你调用 wm.has(key) 返回 false,未必是没设过,可能是 key 已被 GC 回收了。这导致它无法用于需要稳定命中率的缓存策略(比如 LRU、TTL 控制)。
常见误用:
- 用
WeakMap存 API 响应结果,期望多次请求复用——但若请求参数对象是临时创建的(如{ id: 123 }),每次都是新对象,缓存完全失效 - 依赖
wm.size监控缓存水位——它根本不存在,连 polyfill 都没法可靠实现 - 试图用
JSON.stringify()调试内容——WeakMap不可序列化,会直接忽略
真正适合它的缓存,只有一种:输入对象本身就有稳定生命周期,且你愿意接受“它一走,缓存就空”的语义。比如缓存某个组件实例的布局计算结果,而不是缓存某次 fetch 的响应。
容易被忽略的一点:value 是强引用的。如果你在 WeakMap 里存了一个大数组或闭包,而 key 对象恰好被回收了,value 本身不会自动释放——除非它也只被这个 value 引用。所以别在 value 里偷偷 hold 住别的长生命周期对象,否则照样泄漏。










