JavaScript - WeakSet add() 方法

JavaScript WeakSet 的add()方法用于将一个新对象追加到此 WeakSet 的末尾，并返回一个 WeakSet 对象。它接受一个名为“value”的参数，该参数可以是对象或未注册的符号。

注意 - 如果传递给此方法的值无效，则会抛出'TypeError'异常。

JavaScript 中的 WeakSet 是一个集合，它只能包含对象和未注册的符号。它们不能像其他集合（如 Set）那样存储任何类型的任意值。

语法

以下是 JavaScript String add() 方法的语法：

add(value)

参数

此方法接受一个名为“value”的参数，如下所述：

value - 可以是对象或未注册的符号。

返回值

此方法返回一个 WeakSet 对象。

示例

示例 1

如果传递给此方法的值是对象，则将其追加到此 WeakSet 的末尾。

在下面的示例中，我们使用 JavaScript WeakSet 的add()方法将一个新对象（一个空对象 {}）追加到此 WeakSet 的末尾。

<html>
<head>
   <title>JavaScript WeakSet add() Method</title>
</head>
<body>
   <script>
      const Obj = new WeakSet();
      const newObj = {};
      document.write("WeakSet.add(newObj): ", Obj.add(newObj));
      document.write("<br>WeakSet.has(newObj): ", Obj.has(newObj));
   </script>    
</body>
</html>

输出

上述程序返回“[object WeakSet]”。

WeakSet.add(newObj): [object WeakSet]
WeakSet.has(newObj): true

示例 2

如果传递给此方法的值既不是对象也不是未注册的符号，则会抛出'TypeError'异常。

以下是 JavaScript WeakSet add() 方法的另一个示例。在此示例中，我们尝试将一个既不是对象也不是未注册的符号的值“Hello”追加到此 WeakSet 的末尾。

<html>
<head>
   <title>JavaScript WeakSet add() Method</title>
</head>
<body>
   <script>
      const Obj = new WeakSet();
      const str = "Hello";
      document.write("Value: ", str);
      try {
         document.write("<br>WeakSet.add(newObj): ", Obj.add(str));
      } catch (error) {
         document.write("<br>", error);
      }
   </script>    
</body>
</html>

输出

执行上述程序后，它会抛出一个“TypeError”异常。

Value: Hello
TypeError: Invalid value used in weak set

示例 3

除了自定义对象外，还可以使用 JavaScript WeakSet 的add()方法将全局对象（如'window'）追加到此 WeakSet 的末尾。

<html>
<head>
   <title>JavaScript WeakSet add() Method</title>
</head>
<body>
   <script>
      const Obj = new WeakSet();
      document.write("----Before appending----");
      document.write("<br>Does WeakSet has 'window' object? ", Obj.has(window));
      document.write("<br>The 'window' object appended to this WeakSet: ", Obj.add(window));
      document.write("<br>----After appending----");
      document.write("<br>Does WeakSet has 'window' object? ", Obj.has(window));
   </script>    
</body>
</html>

输出

执行上述程序后，它将返回以下语句：

----Before appending----
Does WeakSet has 'window' object? false
The 'window' object appended to this WeakSet: [object WeakSet]
----After appending----
Does WeakSet has 'window' object? true

打印页面