【Node.js24.x】WeakSet::add()メソッドの使い方
addメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
addメソッドは、WeakSetオブジェクトに新しいオブジェクトを追加するために使用するメソッドです。
WeakSetは、オブジェクト型のみを格納できる特殊なコレクションであり、格納されたオブジェクトへの参照が「弱い」という特徴を持ちます。このaddメソッドに引数としてオブジェクトを渡すことで、そのオブジェクトをWeakSetに追加できます。数値や文字列、真偽値などのプリミティブ値を引数として渡そうとすると、TypeErrorが発生しますので注意が必要です。また、同じオブジェクトを複数回追加しようとしても、WeakSet内にはそのオブジェクトが1つだけ保持されるため、重複して追加されることはありません。
「弱い参照」とは、WeakSetに格納されたオブジェクトが、もし他のどこからも参照されなくなった場合、JavaScriptエンジンによって自動的にメモリから解放（ガベージコレクション）される可能性があることを意味します。これにより、不要になったオブジェクトがメモリに残り続けることを防ぎ、アプリケーションのメモリ使用効率を向上させることができます。
addメソッドは、要素を追加した後、そのWeakSetインスタンス自身を返します。このメソッドは、特定のオブジェクトの状態を追跡したり、一時的な関連付けを管理するシナリオで有効活用されます。
構文(syntax)
1const weakSet = new WeakSet(); 2const objectToAdd = {}; 3weakSet.add(objectToAdd);
引数(parameters)
value
- value: any:
WeakSetに追加したい値
戻り値(return)
WeakSet
このメソッドは、WeakSetオブジェクト自体を返します。これにより、メソッドチェーン（メソッドを連続して呼び出すこと）が可能になります。