WeakSet.prototype.add()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

WeakSet 实例的 add() 方法在该 WeakSet 对象的末尾追加一个新的对象。

尝试一下

语法

js
add(value)

参数

value

必须是对象或非全局注册的符号。将要添加到 WeakSet 集合中的值。

返回值

该 WeakSet 对象。

异常

TypeError

如果 value 不是一个对象或非全局注册的符号，则抛出该异常。

示例

使用 add

js
const ws = new WeakSet();

ws.add(window); // 将 window 对象添加到 WeakSet

ws.has(window); // true

// WeakSet 只接受对象作为参数
ws.add(1);
// Chrome 中的结果：“TypeError: Invalid value used in weak set”
// Firefox 中的结果：“TypeError: 1 is not a non-null object”

规范

Specification
ECMAScript® 2025 Language Specification
# sec-weakset.prototype.add

浏览器兼容性

BCD tables only load in the browser

参见