WeakSet

概要

コレクションとして弱保持されたobjectsを格納します。

構文

 new WeakSet([iterable]);

引数

iterable

iterable object が渡された場合、すべての要素は、新しいWeakSetに追加されます。nullはundefinedとして扱われます。

説明

WeakSetオブジェクトはコレクションオブジェクトです。WeakSet内のオブジェクトは一度だけ発生します。すなわち、WeakSetコレクション内で唯一の要素になります。

Setオブジェクトとの主な違いは下記の通りです。:

• Setとの対比で、WeakSetsはオブジェクトのみのコレクションです。すべての型の任意の値のコレクションではありません。
• WeakSetはweakです。: コレクション内のオブジェクトへの参照は弱保持です。WeakSet内に格納されているオブジェクトへの参照が他にない場合、ガベージコレクションされます。これは、コレクション内に格納されている現在のオブジェクトのリストがないことを意味します。WeakSetsは列挙されません。

プロパティ

WeakSet.length

lengthプロパティの値は0です。

WeakSet.prototype

Setコンストラクタに対するプロトタイプを表します。すべてのWeakSetオブジェクトにプロパティを追加できます。

WeakSet インスタンス

すべてのWeakSet インスタンスはWeakSet.prototypeから継承します。

プロパティ

WeakSet.prototype.constructor

Returns the function that created an instance's prototype. This is the WeakSet function by default.

Methods

WeakSet.prototype.add(value)

Appends a new object with the given value to the WeakSet object.

WeakSet.prototype.delete(value)

Removes the element associated to the value. WeakSet.prototype.has(value) will return false afterwards.

WeakSet.prototype.has(value)

Returns a boolean asserting whether an element is present with the given value in the WeakSet object or not.

WeakSet.prototype.clear()

Removes all elements from the WeakSet object.

例

例: WeakSet オブジェクトを使う

var ws = new WeakSet();
var obj = {};
var foo = {};

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

ws.has(window); // true
ws.has(foo);    // false, foo has not been added to the set

ws.delete(window); // removes window from the set
ws.has(window);    // false, window has been removed

ws.clear(); // empty the whole WeakSet

仕様

ブラウザ実装状況

関連情報

• Map
• Set
• WeakMap