【Node.js24.x】WeakMap::get()メソッドの使い方

getメソッドは、Node.jsの組み込み機能であるWeakMapオブジェクトから特定のキーに関連付けられた値を取得するメソッドです。WeakMapは、キーとしてオブジェクトのみを受け入れる特別なコレクションであり、そのキーオブジェクトへの他の参照がなくなった場合、対応するキーと値のペアが自動的にガベージコレクションによって削除される「弱い参照」のメカニズムを持っています。この特性により、不要になったデータがメモリに残り続けるメモリリークのリスクを効果的に低減し、メモリを効率的に管理できます。

このメソッドは引数として、取得したい値に対応するキーオブジェクトを一つ受け取ります。WeakMap内に指定されたキーが存在する場合、getメソッドはそのキーに関連付けられた値を返します。もし指定されたキーが見つからなかった場合は、undefinedを返します。WeakMapの性質上、getメソッドに渡すキーは常にオブジェクトでなければなりません。例えば、あるオブジェクトに一時的な設定情報やプライベートなデータを付与し、そのオブジェクトが使われなくなったときに付随するデータも自動的に消滅させたい、といった場合にこのgetメソッドはWeakMapと共に利用されます。

Copy
1const weakMap = new WeakMap();
2const keyObject = {};
3const value = 'some value';
4
5weakMap.set(keyObject, value);
6
7const retrievedValue = weakMap.get(keyObject);
8// retrievedValue は 'some value'
9const nonExistentValue = weakMap.get({});
10// nonExistentValue は undefined

key

• key: any: 取得したい値に対応するキー

any | undefined

指定されたキーに対応する値を取得します。キーに対応する値が存在しない場合は、undefinedを返します。