JavaScript WeakSet是什么_它与Set有什么区别

WeakSet只能存储对象且不阻止垃圾回收,其成员为弱引用,对象被回收后自动从WeakSet中移除;无size属性、不可迭代,仅支持add()、delete()、has()方法,适用于对象标记而非数据存储。

WeakSet 只能存对象,且不阻止垃圾回收

WeakSet 是 ES6 新增的集合类型,它的核心特性就两点:成员**必须是对象**,而且是**弱引用**。这意味着,如果一个对象只被 WeakSet 引用,而其他地方没有任何变量指向它,那这个对象随时可能被 JavaScript 引擎回收——同时它会自动从 WeakSet 中消失。

这和 Set 完全不同:Set 对所有值(数字、字符串、对象)都持强引用,只要还在 Set 里,对象就永远不会被回收。

  • WeakSet 不能添加基本类型,new WeakSet([1, 'a', {}]) 会直接报错 TypeError: Invalid value used in weak set
  • WeakSet 没有 size 属性,也不能用 for...offorEach 或展开运算符遍历——它压根不提供任何迭代能力
  • WeakSet 的方法只有三个:add()delete()has(),没有 clear(),也没有键或值的获取接口

什么时候该用 WeakSet 而不是 Set

WeakSet 不是用来“存数据”的,而是用来“打标记”的——特别是给对象打临时、生命周期敏感的标记。

典型场景是避免内存泄漏的 DOM 元素状态管理或私有元数据绑定:

const hiddenElements = new WeakSet();

function hide(el) {
  el.style.display = 'none';
  hiddenElements.add(el); // 只要 el 还在页面上,就能查;一旦 el 被 remove(),它自动从 hiddenElements 消失
}

function isHidden(el) {
  return hiddenElements.has(el);
}
  • Set 存 DOM 元素会导致即使元素已从 DOM 移除,仍因 Set 强引用而无法回收,造成隐性内存泄漏
  • WeakSet 在这里天然契合:你不需要遍历所有隐藏元素,只需要快速判断“这个元素是否曾被 hide 过”
  • 同理适用于类实例的私有状态标记(比如“是否已初始化”“是否正在加载中”),无需修改原型或暴露属性

WeakSet 不能替代 Set 的常见误用

开发者常误以为 WeakSet 是“轻量版 Set”,想用它来去重、缓存或做集合运算——这是危险的。

  • 无法实现数组去重:[...new WeakSet([1, 2, 2])] 语法错误,因为 12 不是对象
  • 无法做交集/并集:没有 values()keys(),连读取都做不到,更别说计算了
  • 无法调试或日志输出:console.log(weakSet) 只显示 WeakSet { },内容不可见
  • 测试困难:因为无法遍历或获知当前大小,断言 weakSet.size === 3 这类检查根本写不出来

兼容性和运行时行为要点

WeakSet 在所有现代浏览器和 Node.js ≥ 6.0 中都可用,但要注意它的“不可观测性”是设计使然,不是 bug。

  • WeakSet 的 has() 返回结果只反映“此刻该对象是否还活着且被引用”,不是“是否曾经 add 过”——对象一旦被回收,has() 立即返回 false
  • 没有 polyfill 能真正模拟 WeakSet 的弱引用语义;Babel 只能降级为 Map + 手动清理,失去自动回收优势
  • Node.js 中可通过 --expose-gcglobal.gc() 触发回收来验证 WeakSet 行为,但生产环境不应依赖此机制
WeakSet 的价值不在功能多,而在“恰好不多”——它用缺失的 API(遍历、size、基础类型支持)换来对对象生命周期的零干预。一旦你发现自己需要看它里面有什么、或者想让它活久一点,那就该换回 SetMap 了。