WeakRef 是 JavaScript 中不阻止对象被垃圾回收的弱引用,需用 .deref() 获取值且可能返回 undefined;WeakMap 以对象为弱键绑定数据,键回收后条目自动消失;WeakSet 仅用于标记对象是否存活,三者均不能解决全局引用等根本性内存泄漏。

WeakRef 是什么,为什么不能随便用
WeakRef 是 JavaScript 中一种持有对象但不阻止其被垃圾回收的引用方式。它本身不“强持有”目标对象——只要该对象没有其他强引用存在,即使还有 WeakRef 指向它,GC 也能照常回收。
但它不是万能缓存工具:你不能直接从 WeakRef 实例上取值,必须调用 .deref();而这个方法可能返回 undefined(对象已被回收),所以每次使用前都得做存在性检查。
-
WeakRef构造函数只接受一个对象,不能是原始值(如42、"hello") - 不能用于 DOM 元素或跨 Realm 对象(比如 iframe 里的对象),部分引擎会抛
TypeError - V8 和 SpiderMonkey 支持,但 Safari 16.4+ 才开始稳定支持,旧版 iOS Safari 会静默失败
const obj = { name: 'test' };
const ref = new WeakRef(obj);
console.log(ref.deref()); // { name: 'test' }
obj = null; // 切断唯一强引用
// 此时 ref.deref() 可能返回 undefined(取决于 GC 是否已运行)
WeakMap 的键必须是对象,且不可枚举
WeakMap 的设计目标很明确:把数据绑定到对象上,又不想干扰它的生命周期。WeakMap 的键只能是对象(包括函数、数组、元素节点等),且这些键是“弱持有”的——一旦键对象被回收,对应条目自动消失,无需手动清理。
它不暴露键列表,也没有 .keys()、.values() 或 .entries() 方法,也不能被遍历。这是刻意为之:避免因枚举行为隐式保留键对象引用。
立即学习“Java免费学习笔记(深入)”;
- 适合做私有元数据存储,比如给第三方类实例挂载内部状态而不污染原型
- 不能用字符串、数字、
null、undefined当键,否则抛TypeError - 同一个对象作为键多次
set,会覆盖而非新增条目
const cache = new WeakMap();
const el = document.getElementById('app');
cache.set(el, { lastUpdated: Date.now() });
// el 被移除 DOM 且无其他引用后,cache 里这组键值对自动失效
// 无法通过 cache.keys() 查看有哪些键,也无法 for...of 遍历
WeakSet 和 WeakRef / WeakMap 的根本区别
WeakSet 只存对象,且只提供 .add()、.has()、.delete(),没有迭代能力。它和 WeakMap 一样,成员对象被回收后自动剔除;但和 WeakRef 不同,它不提供“尝试读取”机制,也不绑定额外数据。
典型用途是标记对象是否已处理过,比如防重复初始化:
- 不能用
new WeakSet([1, 2])初始化,数组元素非对象会报错 - 不能用
WeakSet.prototype.forEach,它根本没有这个方法 - 它不持有值的“所有权”,只是观察对象是否还活着
const processed = new WeakSet();
function init(obj) {
if (processed.has(obj)) return;
// ...初始化逻辑
processed.add(obj);
}
// obj 被回收后,processed.has(obj) 必然返回 false
它们真能帮你避免内存泄漏吗
能,但仅限于“意外强引用”场景。比如缓存 DOM 节点却忘了清理、在事件监听器里闭包捕获了大对象、给大量临时对象打标记却不释放——这些地方用 WeakMap 或 WeakSet 可以让 GC 正常工作。
但它们不解决真正的内存泄漏根源:比如全局变量持续引用、定时器没清除、闭包长期持有不需要的数据、或反复 new WeakRef 却不管理生命周期。
-
WeakRef实例本身是强引用,如果把它存在全局数组里,就等于又制造了一个强引用链 -
WeakMap的 value 如果是闭包或大数组,仍会被强持有——弱的是 key,不是 value - Node.js 中 V8 的 GC 策略可能导致
WeakRef回收时机比预期晚,不要依赖“立刻失效”
真正要盯住的,永远是引用图里有没有不该存在的强路径。Weak 系列 API 只是给你少写几行 delete map[key] 的机会,不是自动内存管家。











