---
title: WeakSet
slug: Web/JavaScript/Reference/Global_Objects/WeakSet
tags:
  - ECMAScript6
  - JavaScript
  - WeakSet
translation_of: Web/JavaScript/Reference/Global_Objects/WeakSet
---
<div>{{JSRef()}}</div>

<p>Объект <strong><code>WeakSet</code></strong> - коллекция, элементами которой могут быть только <em>объекты. </em>Ссылки на эти объекты в WeakSet являются слабыми. Каждый объект может быть добавлен в WeakSet только один раз.</p>

<h2 id="Syntax">Синтаксис</h2>

<pre class="syntaxbox"> new WeakSet([iterable]);</pre>

<h3 id="Parameters">Параметры</h3>

<dl>
 <dt>iterable</dt>
 <dd>При передаче <a href="https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Statements/for...of">итерируемого объекта</a>, все его элементы будут добавлены в новый WeakSet. <code>Null</code> обрабатывается как <code>undefined</code>.</dd>
</dl>

<h2 id="Description">Описание</h2>

<p>Объекты <code>WeakSet </code>представляют собой коллекции объектов. Каждый объект в WeakSet встречается только один раз, что обеспечивает его уникальность в рамках коллекции WeakSet.</p>

<p>Главным отличия от объекта {{jsxref("Set")}}:</p>

<ul>
 <li>WeakSet <strong>содержит только объекты</strong>, тогда как Set - значения любого типа.</li>
 <li>Ссылки на объекты в WeakSet являются слабыми: если на объект, хранимый в WeakSet нет ни одной внешней ссылки, то сборщик мусора удалит этот объект. Также это означает, что WeakSet <strong>не итерируем, </strong>так как нет возможности получить список текущих хранимых в WeakSet объектов.  </li>
</ul>

<h2 id="Properties">Свойства</h2>

<dl>
 <dt><code>WeakSet.length</code></dt>
 <dd>Значение свойства <code>length</code> всегда равно 0.</dd>
 <dt>{{jsxref("WeakSet.prototype")}}</dt>
 <dd>Представляет прототип конструктора Weak<code>Set</code>. Позволяет добавлять свойства  всем объектам типа <code>WeakSet</code>.</dd>
</dl>

<h2 id="Экземпляры_WeakSet"><code>Экземпляры WeakSet</code> </h2>

<p>Все экземпляры класса <code>WeakSet</code> унаследованы от {{jsxref("WeakSet.prototype")}}.</p>

<h3 id="Properties_2">Свойства</h3>

<p>{{page('ru/docs/Web/JavaScript/Reference/Global_Objects/WeakSet/prototype','Properties')}}</p>

<h3 id="Methods">Методы</h3>

<p>{{page('ru/docs/Web/JavaScript/Reference/Global_Objects/WeakSet/prototype','Methods')}}</p>

<h2 id="Examples">Примеры</h2>

<h3 id="Example:Using_the_WeakSet_object">Использование объекта <code>WeakSet</code> </h3>

<pre class="brush: js">var ws = new WeakSet();
var obj = {};
var foo = {};

ws.add(window);
ws.add(obj);

ws.has(window); // true
ws.has(foo);    // false, foo не добавлен в WeakSet

ws.delete(window); // удаляет window из WeakSet
ws.has(window);    // false, window был удалён
</pre>

<h2 id="Specifications">Спецификации</h2>

{{Specifications}}

<h2 id="Browser_compatibility">Совместимость с браузерами</h2>

<p>{{Compat("javascript.builtins.WeakSet")}}</p>

<div id="compat-mobile"> </div>

<h2 id="See_also">Смотрите также</h2>

<ul>
 <li>{{jsxref("Map")}}</li>
 <li>{{jsxref("Set")}}</li>
 <li>{{jsxref("WeakMap")}}</li>
</ul>