1. 首页
  2. JavaScript 菜鸟教程
  3. JavaScript - WeakSet add() 方法

JavaScript - WeakSet add() 方法

JavaScript WeakSet add（） 方法用于将新对象追加到此 WeakSet 的末尾，并返回一个 WeakSet 对象。它接受一个名为 'value' 的参数，它可以是对象或未注册的元件。

注意 − 如果传递给此方法的值无效，则会引发 'TypeError' 异常。

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

语法

以下是 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
<< JavaScript - Set.values() 方法 JavaScript - WeakSet delete() 方法 >>