WeakSet.prototype.add()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年9月以降、すべてのブラウザーで利用可能です。
add() メソッドは、新しい要素を WeakSet オブジェクトの最後に追加します。
試してみましょう
const weakset1 = new WeakSet();
const object1 = {};
weakset1.add(object1);
console.log(weakset1.has(object1));
// 予想される結果: true
try {
weakset1.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
}
構文
ws.add(value);
引数
value-
必須。
WeakSetコレクションに追加する要素の値です。
返値
WeakSet オブジェクトです。
例
add() の使用
js
var ws = new WeakSet();
ws.add(window); //window オブジェクトを WeakSet へ追加
ws.has(window); // true
// WeakSet は引数としてオブジェクトのみを取ります。
ws.add(1);
// 結果は "TypeError: Invalid value used in weak set" (Chrome)
// "TypeError: 1 is not a non-null object" (Firefox)
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification # sec-weakset.prototype.add |