blob: e8a91c25a251d8fa6da2931e5f793477e097ee0e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
---
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>
|
