必须用weakmap而非普通map或对象,因其对键仅持弱引用,不阻止垃圾回收;而map/对象持强引用,会导致dom节点或实例无法释放,引发内存泄漏。

用 WeakMap 管理实例的临时元数据,核心是利用它对键(即对象实例)的弱引用特性:只要该实例在其他地方不再被强引用,它就能被垃圾回收,WeakMap 中对应的条目也会自动失效——无需手动清理,也不会导致内存泄漏。
为什么必须用 WeakMap 而不是普通对象或 Map
普通对象或 Map 会对键保持强引用。比如把 DOM 节点或类实例作为键存进 Map,即使节点已从页面移除、实例本该被回收,只要 Map 还持有它,它就一直驻留在内存中。WeakMap 不会阻止回收,这是它不可替代的关键。
- Map / 普通对象:键被长期持有时,对象无法释放 → 内存泄漏风险高
- WeakMap:键仅被弱持有 → 实例无其他引用时,GC 可立即回收,条目同步消失
- WeakMap 的键只能是对象(DOM 节点、class 实例、普通 object 都符合),原始值(如字符串、数字)会直接报错
典型使用模式:封装一个安全的元数据管理器
不建议每次都在函数里 new WeakMap(),而应统一维护一个模块级单例,并提供语义清晰的 get/set/delete 接口:
- 用 Object.create(null) 初始化每个实例的元数据容器,避免原型污染和 hasOwnProperty 冲突
- set 时先检查是否存在,避免重复创建空对象
- get 时做存在性判断,防止访问 undefined.key 报错
- delete 只删字段,不删整个对象;若需清空全部元数据,可额外提供 clearAll(node) 方法
实际应用示例:为类实例附加私有状态
在没有 # 私有字段语法(或需兼容旧环境)时,WeakMap 是实现真正私有成员的安全方式:
- 定义一个外部 WeakMap,如 const _meta = new WeakMap()
- 构造函数中执行 _meta.set(this, { timer: null, isInitialized: false })
- 所有方法通过 _meta.get(this).timer 访问,外部代码无法触达
- 当 this 实例被销毁,_meta 中对应项自动失效,不留残留
需要注意的边界情况
WeakMap 只弱化键,不管理值:
- 如果值本身是大对象(比如缓存了整张图片数据),又在别处被闭包或全局变量意外持有,它仍不会被回收
- WeakMap 不支持遍历、没有 size、不能 clear() —— 这不是缺陷,而是刻意设计,防止开发者误操作延长对象生命周期
- 不要试图用 WeakMap 替代解绑逻辑:定时器未 clearTimeout、事件监听器未 removeEventListener,照样泄漏,WeakMap 无法兜底










