WeakMap 适合模拟私有属性,因其键必须为对象且是弱引用,实例销毁时自动回收内存;外部无法遍历,数据与实例强绑定、完全隔离;推荐在模块顶层定义 WeakMap 并于构造函数中一次性初始化私有数据对象。

直接用 Map 模拟私有属性,核心是把实例作为 key、私有数据作为 value 存进一个外部不可访问的 Map 中。这样既避免了闭包长期持有引用导致的内存泄漏风险,又比 Symbol 或 # 字段更兼容、比普通对象属性更隔离。
为什么 Map(尤其是 WeakMap)适合模拟私有属性
普通对象属性名可被枚举、修改、序列化,无法真正隐藏;Symbol 是“约定私有”,仍能被 Object.getOwnPropertySymbols() 拿到;# 字段语法简洁但兼容性受限(IE 不支持,旧版 Node/Safari 也不行)。WeakMap 则天然满足三个关键条件:
- key 必须是对象,且是弱引用 —— 实例被销毁时,对应私有数据自动回收,不卡内存
- 外部无法遍历或获取其内容,
weakMap.keys()根本不存在 - 私有数据与实例强绑定,不同实例间完全隔离,不会互相干扰
用 WeakMap 实现类级私有状态(推荐写法)
在模块顶层定义一个 WeakMap,构造函数中为每个实例设置专属私有数据对象:
const privateData = new WeakMap();
<p>class Counter {
constructor(initial = 0) {
// 每个实例独享一份私有数据
privateData.set(this, { count: initial });
}</p><p>increment() {
const data = privateData.get(this);
data.count++;
}</p><p>get value() {
return privateData.get(this).count;
}
}</p><p>const a = new Counter(10);
const b = new Counter(100);
console.log(a.value); // 10
console.log(b.value); // 100
// 外部无法访问 privateData,也无法通过 a 拿到 b 的数据
注意避开两个典型错误
WeakMap 的正确用法容易被误写,以下两种情况会破坏封装性或引发内存问题:
- 用普通
Map替代WeakMap:key 是强引用,实例即使不用了,私有数据也不会被 GC 回收,造成内存泄漏 - 在方法里重复调用
privateData.set(this, ...):每次都会覆盖原值,丢失已有状态;应只在构造函数中初始化一次,后续统一用get()取出后操作
扩展:多个私有字段的结构组织
如果需要管理多个私有字段(比如 count、createdAt、isRunning),不要为每个字段单独建一个 WeakMap。统一存成一个对象更清晰、更高效:
const privateData = new WeakMap();
<p>class Timer {
constructor() {
privateData.set(this, {
count: 0,
createdAt: Date.now(),
isRunning: false,
callbacks: []
});
}</p><p>start() {
const data = privateData.get(this);
data.isRunning = true;
}</p><p>onTick(cb) {
const data = privateData.get(this);
data.callbacks.push(cb);
}
}

















