WeakSet

WeakSet 对象允许你将弱保持对象存储在一个集合中。

描述

WeakSet 对象是一些对象值的集合。且其与 Set 类似，WeakSet 中的每个对象值都只能出现一次。在 WeakSet 的集合中，所有对象都是唯一的。

它和 Set 对象的主要区别有：

WeakSet 只能是对象的集合，而不能像 Set 那样，可以是任何类型的任意值。
WeakSet 持弱引用：集合中对象的引用为弱引用。如果没有其它的对 WeakSet 中对象的引用，那么这些对象会被当成垃圾回收掉。

备注： 这也意味着 WeakSet 中没有存储当前对象的列表。正因为这样，WeakSet 是不可枚举的。

用例：检测循环引用

递归调用自身的函数需要一种通过跟踪哪些对象已被处理，来应对循环数据结构的方法。

为此，WeakSet 非常适合处理这种情况：

// 对 传入的 subject 对象 内部存储的所有内容执行回调
function execRecursively(fn, subject, _refs = new WeakSet()) {
  // 避免无限递归
  if (_refs.has(subject)) {
    return;
  }

  fn(subject);
  if (typeof subject === "object") {
    _refs.add(subject);
    for (const key in subject) {
      execRecursively(fn, subject[key], _refs);
    }
  }
}

const foo = {
  foo: "Foo",
  bar: {
    bar: "Bar",
  },
};

foo.bar.baz = foo; // 循环引用！
execRecursively((obj) => console.log(obj), foo);

在此，在第一次运行时创建 WeakSet，并将其与每个后续函数调用一起传递（使用内部参数 _refs）。

对象的数量或它们的遍历顺序无关紧要，因此，WeakSet 比 Set 更适合（和执行）跟踪对象引用，尤其是在涉及大量对象时。

构造函数

WeakSet() (en-US): 创建一个新的 WeakSet 对象。

实例方法

WeakSet.prototype.add(value): 将 value 添加到 WeakSet 对象最后一个元素的后面。
WeakSet.prototype.delete(value): 从 WeakSet 中移除 value。此后调用 WeakSet.prototype.has(value) 将返回 false。
WeakSet.prototype.has(value): 返回一个布尔值，表示 value 是否存在于 WeakSet 对象中。

示例

使用 WeakSet 对象

const ws = new WeakSet();
const foo = {};
const bar = {};

ws.add(foo);
ws.add(bar);

ws.has(foo);    // true
ws.has(bar);    // true

ws.delete(foo); // 从 set 中删除 foo 对象
ws.has(foo);    // false，foo 对象已经被删除了
ws.has(bar);    // true，bar 依然存在

注意，foo !== bar。尽管它们是相似的对象，但是它们不是**同一个对象**。因此，它们都可以被加入到 set 中。

规范

Specification
ECMAScript Language Specification # sec-weakset-objects

浏览器兼容性

BCD tables only load in the browser