WeakMap 是键必须为对象且弱引用的集合,不阻止垃圾回收,无遍历和 size 方法,适用于 DOM 状态绑定、类私有属性等临时元数据挂载场景,与 Map 互补而非替代。

WeakMap 是 JavaScript 中一种特殊的键值对集合,它的核心作用是让对象作为键时不会阻止垃圾回收,从而避免内存泄漏。
WeakMap 的键必须是对象,且是弱引用
WeakMap 只接受对象(包括函数、数组等)作为键,原始值(如字符串、数字)会直接报错。更重要的是,它对键的引用是“弱引用”——也就是说,如果一个对象只被 WeakMap 引用,而外部没有其他强引用,那么垃圾回收器(GC)可以随时回收这个对象,同时 WeakMap 中对应的键值对也会自动消失。
- Map 对键是强引用:对象被 Map 持有后,即使外部设为 null,也不会被回收
- WeakMap 对键是弱引用:对象一旦失去所有外部引用,GC 就能清理它,无需手动干预
- 这种机制天然适配 JS 的垃圾回收逻辑,不需要开发者额外维护生命周期
它不支持遍历和 size 查询
WeakMap 没有 keys()、values()、entries() 或 size 属性,也不能用 for...of 遍历。这不是缺陷,而是设计使然:防止暴露内部条目,避免干扰 GC 判断,也强化了“临时附着元数据”的语义。
- 你只能通过已知对象去 get()、set()、has()、delete()
- 无法枚举意味着无法意外依赖其内容做状态判断,降低了误用风险
- 这也让 WeakMap 更适合做“私有挂载区”,而不是通用存储容器
典型应用场景:DOM 数据绑定与类私有属性
WeakMap 常用于两类高频内存敏感场景:
本文档主要讲述的是关于Objective-C手动内存管理的规则;在ios开发中Objective-C 增加了一些新的东西,包括属性和垃圾回收。那么,我们在学习Objective-C之前,最好应该先了解,从前是什么样的,为什么Objective-C 要增加这些支持。有需要的朋友可以下载看看
立即学习“Java免费学习笔记(深入)”;
- 给 DOM 节点附加临时状态:比如记录点击次数、加载状态、表单验证结果。节点被移除后,数据自动释放,不用监听 DOMNodeRemoved 或手动清理
- 模拟类的真正私有字段:把实例作为键,存入闭包外的 WeakMap 中。外部无法访问该 Map,也无法通过反射获取,且实例销毁时数据一并消失
- 第三方库或插件中为任意对象“打标签”或缓存计算结果,又不想影响其生命周期
它不是 Map 的替代品,而是互补工具
WeakMap 不可迭代、不能查大小、不能用原始值作键,这些限制让它不适合做通用映射或长期缓存。它存在的意义不是“更轻量的 Map”,而是解决一类 Map 无法处理的问题:当你要把数据“挂”在某个对象上,又不希望因此延长它的寿命。
- 需要长期持有、可遍历、支持任意键类型 → 用 Map
- 只为某个对象临时附加元数据,且希望随对象一起消失 → 用 WeakMap
- 两者共存不冲突,常配合使用:Map 管主数据流,WeakMap 管附属生命周期










