WeakSet 是只存储对象弱引用的不可遍历集合,支持 add()、has()、delete() 方法,适用于对象标记、私有状态管理及避免内存泄漏;不支持原始值、size 属性或遍历。

WeakSet 是 JavaScript 中一种特殊的集合类型,它的核心特点是:只存储对象引用,且这些引用是“弱引用”——不会阻止垃圾回收器回收这些对象。换句话说,如果一个对象只被 WeakSet 持有,而其他地方都不再引用它,那它就会被自动从内存中清除,WeakSet 内部也会随之失去对该对象的记录。
WeakSet 的基本特性
• 只能存放对象(不能放原始值如字符串、数字、null、undefined)
• 成员是弱引用,不阻碍 GC(垃圾回收)
• 不可遍历(没有 keys()、values()、entries() 方法,也没有 forEach)
• 没有 size 属性,无法获知当前有多少成员
• 提供 add()、has()、delete() 三个方法,仅此而已
适合用 WeakSet 的典型场景
1. 对象身份标记(避免修改原对象)
当你需要临时标记某些对象“已处理过”“正在渲染中”“已被订阅”,又不想给对象加属性(比如 obj.seen = true)污染其结构或引发原型链问题时,WeakSet 是理想选择。它轻量、无侵入、自动清理。
例如:防止 DOM 元素重复初始化
一、外卖通叫餐(预订)系统单店版是什么样的一个系统? 外卖通系列软件是针对非商品性买卖、有别于传统的商城系统的、外卖和预订为概念性的店铺管理系统,我们的口号就是:让所有的门店在网上安个家,以往的版本都是基于多用户性质的平台系统,而外卖通单店版是基于某个店铺的专业外卖预订管理系统,设计了外卖、预订、专题活动、小游戏、资讯、形象、点评、积分、相册等多种功能模块以适应商家办站的各种需求。这套系统可
const initialized = new WeakSet();
function initElement(el) {
if (initialized.has(el)) return;
// 执行初始化逻辑
initialized.add(el);
}
2. 私有状态管理(配合闭包或模块封装)
在类或模块内部,用 WeakSet 存储与实例强绑定但不希望暴露给外部的元信息,比如是否已销毁、是否启用调试模式等。因为 WeakSet 不可遍历、不可导出,天然具备封装性。
3. 避免内存泄漏的事件监听/观察者场景
比如你为某个对象注册了回调,希望当该对象被销毁时,相关监听也自动失效。把监听目标存进 WeakSet,配合定时检查 has() 或结合 finalize 注册(需配合 FinalizationRegistry),可实现更安全的生命周期联动。
不适合 WeakSet 的情况
• 需要遍历所有成员(WeakSet 不支持迭代)
• 需要知道当前存了多少个对象(没有 size)
• 要存字符串、数字等原始值(会直接报错)
• 需要长期稳定持有对象(WeakSet 的“弱”意味着它可能随时变空)
WeakSet 不是通用集合替代品,而是针对特定内存敏感、临时关联、对象身份标识类需求设计的轻量工具。用对了,代码更健壮;用错了,反而带来难以调试的“消失行为”。










