WeakSet.prototype.add()

Метод add() экземпляров WeakSet вставляет указанное значение в это множество, если оно еще не присутствует.

Попробовать

const weakset = new WeakSet();
const object = {};

weakset.add(object);
console.log(weakset.has(object));
// Expected output: true

try {
  weakset.add(1);
} catch (error) {
  console.log(error);
  // Expected output (Chrome): TypeError: Invalid value used in weak set
  // Expected output (Firefox): TypeError: WeakSet value must be an object, got 1
  // Expected output (Safari): TypeError: Attempted to add a non-object key to a WeakSet
}

Синтаксис

add(value)

Параметры

value

Значение, которое нужно добавить в объект WeakSet. Должно быть либо объектом, либо незарегистрированным символом. Объекты сравниваются по ссылке, а не по значению.

Возвращаемое значение

Объект WeakSet.

Исключения

TypeError

Выбрасывается, если value не является объектом или незарегистрированным символом.

Примеры

Использование add()

const ws = new WeakSet();

ws.add(window); // add the window object to the WeakSet

ws.has(window); // true

// WeakSet only takes objects as arguments
ws.add(1);
// results in "TypeError: Invalid value used in weak set" in Chrome
// and "TypeError: 1 is not a non-null object" in Firefox

Спецификации

Совместимость с браузерами

Смотрите также

• WeakSet
• WeakSet.prototype.delete()
• WeakSet.prototype.has()