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

列印頁面