WeakSet 是仅存储对象且不阻止垃圾回收的集合,具有弱引用特性,只提供 add、delete、has 方法,适用于私有状态标记和避免内存泄漏,不可用于缓存或遍历。

WeakSet 是什么:一个只能存对象、且不阻止垃圾回收的集合
WeakSet 不是普通 Set 的弱化版,而是设计目标完全不同的结构:WeakSet 只接受对象(包括数组、函数、DOM 节点等)作为值,且对所存对象是「弱引用」——只要该对象在其他地方不再被引用,即使它还在 WeakSet 中,也会被 JavaScript 引擎自动回收。
这意味着:WeakSet 无法遍历、没有 .size 属性、不支持 .clear(),只提供 .add()、.delete() 和 .has() 三个方法。
WeakSet 不能用来做缓存或长期存储
这是最容易踩的坑:有人看到「Weak」就以为是「轻量版 Set」,试图用它存计算结果或临时状态。但因为对象随时可能被回收,WeakSet.has(obj) 下一秒就可能返回 false,导致逻辑断裂。
以下场景绝对不合适:
立即学习“Java免费学习笔记(深入)”;
- 用
WeakSet缓存函数执行结果(对象回收后缓存失效不可控) - 代替布尔标记位长期跟踪某个对象是否“已处理”(除非你明确依赖它的自动清理)
- 需要枚举所有已加入对象的场景(
WeakSet根本不支持迭代)
真正适用的典型场景:私有状态标记与 DOM 节点生命周期绑定
WeakSet 的价值在于「零成本清理」——你不需要手动调用 .delete(),只要对象自然销毁,内存就释放。这特别适合两类需求:
- 给第三方对象打标记而不影响其生命周期:比如在不修改原始对象的前提下,标记某个 DOM 元素是否已被初始化过插件
-
避免循环引用导致的内存泄漏:例如在事件监听器中引用组件实例,又让组件实例持有监听器,用
WeakSet存储监听目标可打破强引用链
示例:防止对同一 DOM 节点重复绑定初始化逻辑
const initializedNodes = new WeakSet();
function initNode(node) {
if (initializedNodes.has(node)) return;
// 执行初始化...
initializedNodes.add(node);
}
当 node 从 DOM 中移除且无其他引用时,它会自动从 initializedNodes 中消失,无需任何清理代码。
WeakSet vs Set:选错就等于引入不确定性
如果对象是你自己创建并可控生命周期的(比如配置项、内部数据结构),几乎总是该用 Set;只有当你操作的是外部传入、生命周期不受你控制的对象(尤其是 DOM 节点、用户传入的回调上下文、第三方库实例)时,WeakSet 才有意义。
另外注意兼容性:WeakSet 在 IE 完全不支持,Node.js 6+ 开始支持,现代浏览器均可用。若需降级,无法真正模拟「弱引用」语义,只能退回到 Map + 手动管理,但会失去自动回收优势。
它的存在不是为了替代 Set,而是为了解决一个非常具体的问题:如何在不延长对象寿命的前提下,建立对象到元信息的映射。一旦忽略「弱引用」这个核心约束,就容易把它用成一个残缺的 Set,反而增加维护负担。











