WeakSet 是仅存储对象的弱引用集合,不阻止垃圾回收,不可遍历,只提供 add、delete、has 方法,适用于临时标记、防重复操作等需自动清理的场景。

WeakSet 是 JavaScript 中一种特殊的集合类型,它只存储对象引用,且这些引用是“弱”的——不会阻止垃圾回收机制回收这些对象。
WeakSet 只能存对象,不能存原始值
和 Set 不同,WeakSet 的 add() 方法只接受对象(包括函数、数组、普通对象等),传入 null、undefined、字符串、数字或布尔值会直接报错。这是因为 WeakSet 的设计目标就是配合对象生命周期管理,原始值本身没有引用计数问题,也不需要“弱引用”机制。
- ✅ 正确:
ws.add({})、ws.add(document.body)、ws.add(() => {}) - ❌ 报错:
ws.add("hello")、ws.add(42)、ws.add(null)
WeakSet 中的对象引用是“弱”的
所谓“弱”,是指 WeakSet 持有的对象引用不会被计入 JavaScript 引擎的垃圾回收判定条件。如果一个对象只被 WeakSet 引用,而其他地方都不再持有它的引用,那么这个对象就会被自动回收,WeakSet 内部也会随之失去对该对象的记录(不需要手动清理)。
这使得 WeakSet 天然适合做“临时标记”:比如你想知道某个 DOM 元素是否已被处理过,又不想因为标记本身阻止元素被卸载。
立即学习“Java免费学习笔记(深入)”;
大高朋团购系统是一套Groupon模式的开源团购程序,开发的一套网团购程序,系统采用ASP+ACCESS开发的团购程序,安装超简,功能超全面,在保留大高朋团购系统版权的前提下,允许所有用户免费使用。大高朋团购系统内置多种主流在线支付接口,所有网银用户均可无障碍支付;短信发送团购券和实物团购快递发货等。 二、为什么选择大高朋团购程序系统? 1.功能强大、细节完善 除了拥有主流团购网站功能,更特别支
- 例如:在事件委托中,用 WeakSet 记录已绑定过特定监听器的元素,页面跳转后元素被销毁,WeakSet 不会阻止回收,也无需手动清理
- 对比 Set:若用 Set 存储,即使元素从 DOM 中移除,只要 Set 还持有引用,该对象就无法被回收,可能造成内存泄漏
WeakSet 不可遍历,API 非常精简
WeakSet 没有 keys()、values()、entries(),也没有 forEach 方法,也不能用 for...of 遍历。它只提供三个方法:
-
add(value)—— 添加一个对象 -
delete(value)—— 删除指定对象(返回布尔值) -
has(value)—— 判断是否包含某对象(返回布尔值)
这种限制不是缺陷,而是刻意为之:避免开发者试图“读取全部内容”,从而干扰弱引用的设计初衷。你只能问“它有没有这个对象”,不能问“它有哪些对象”。
典型用途:私有状态标记与防重复操作
WeakSet 常用于不污染对象自身、也不影响内存回收的轻量级标记场景:
- 为对象打“已初始化”标签(如类的构造函数中检查是否重复初始化)
- 在框架中跟踪哪些 DOM 节点已挂载了自定义行为
- 实现私有属性模拟(配合闭包或模块作用域,WeakSet 作为外部存储容器)
- 防止函数对同一对象多次执行副作用(如只对新出现的元素添加动画)
它不替代 Set,也不追求通用性,而是在特定边界下解决“临时关联 + 自动清理”这一类问题。










