WeakSet() constructor

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.

The WeakSet() constructor creates WeakSet objects.

Syntax

new WeakSet()
new WeakSet(iterable)

Note: WeakSet() can only be constructed with new. Attempting to call it without new throws a TypeError.

Parameters

iterable Optional: If an iterable object is passed, all of its elements will be added to the new WeakSet. null is treated as undefined.

Examples

Using the WeakSet object

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); // removes foo from the set
ws.has(foo); // false, foo has been removed
ws.has(bar); // true, bar is retained

Note that foo !== bar. While they are similar objects, they are not the same object. And so they are both added to the set.

Specifications

Specification
ECMAScript® 2027 Language Specification # sec-weakset-constructor

Browser compatibility

	Desktop					Mobile							Server
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS	Bun	Deno	Node.js
`WeakSet`	36	12	34	23	9	36	34	24	9	3.0	37	9	1.0.0	1.0	0.12.0
`iterable_allowed`	38	12	34	25	9	38	34	25	9	3.0	38	9	1.0.0	1.0	0.12.0
`null_allowed`	36	12	37	23	9	36	37	24	9	3.0	37	9	1.0.0	1.0	0.12.0