如何用 WeakMap 实现私有属性的存储并防止内存泄漏-js教程-PHP中文网

WeakMap适合存私有属性，因其键必须是对象且为弱引用，对象无其他引用时GC可自动回收，避免内存泄漏；常用于类实例的缓存、状态标记等，需将WeakMap声明在模块顶层共享，而非每次实例化新建。

如何用 weakmap 实现私有属性的存储并防止内存泄漏

WeakMap 为什么适合存私有属性

因为 WeakMap 的键必须是对象，且对键是弱引用——只要对象没被其他地方引用，哪怕它还在 WeakMap 里，GC 也能回收它。这天然规避了用普通 Map 或对象字面量做私有存储时常见的内存泄漏：比如把 DOM 元素当 key 存进 Map，但元素已被移除却忘了手动 delete，就一直占着内存。

实际场景中，你常会想给某个类实例“挂”些不希望被外部访问、也不希望阻碍 GC 的数据，比如缓存计算结果、内部状态标记、或绑定的事件回调引用。WeakMap 正是干这个的。

典型写法：在构造函数里绑定 WeakMap 实例

关键点不是「用 WeakMap」，而是「怎么组织它的生命周期」。最稳妥的做法是把 WeakMap 声明在模块顶层（或类外部作用域），而不是每次 new 实例都新建一个：

const privateStore = new WeakMap();
<p>class Counter {
constructor() {
// 每个实例都作为 key，存自己的私有数据
privateStore.set(this, { count: 0, createdAt: Date.now() });
}</p><p>increment() {
const priv = privateStore.get(this);
priv.count++;
}</p><p>getCount() {
return privateStore.get(this)?.count ?? 0;
}
}</p>

这样写有几个好处：

privateStore 是单例，所有实例共享同一张表，不会重复创建结构
实例被销毁后，privateStore 里对应的条目自动失效，无需手动清理
外部代码无法访问 privateStore，也就拿不到私有字段

容易踩的坑：闭包捕获 this 或误用字符串 key

常见错误是把 WeakMap 写在方法里，或者试图用非对象当 key：

❌ 在实例方法中新建 WeakMap：new WeakMap() 放在 increment 里 —— 每次调用都新建，完全失去复用和弱引用意义
❌ 用字符串当 key：privateStore.set('some-id', value) —— WeakMap 会直接报错 TypeError: Invalid value used as weak map key
❌ 用箭头函数绑定了 this，但又在别处保留了对函数的引用（比如传给 addEventListener），导致实例无法被 GC —— 这不是 WeakMap 的问题，但 WeakMap 不会帮你解决这种间接引用泄漏

WeakMap 只管「键是否还活着」，不管「值里有没有反向引用」。如果私有数据里存了对当前实例的强引用（比如 { owner: this }），那还是可能泄漏。