【Node.js24.x】WeakMap::delete()メソッドの使い方
deleteメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
deleteメソッドは、Node.jsの組み込みオブジェクトであるWeakMapインスタンスから、指定されたキーとそれに対応する値のエントリを削除するメソッドです。
WeakMapは、キーにオブジェクト、値に任意のデータを関連付けることができるコレクションです。その最大の特徴は、キーへの参照が「弱参照」であることです。これにより、キーとして使われたオブジェクトが他にどこからも参照されなくなった場合、JavaScriptのガベージコレクションによって自動的にメモリから解放され、WeakMap内の対応するエントリも同時に消滅します。
このdeleteメソッドは、開発者が明示的に特定のキーと関連データをWeakMapから削除する際に利用します。メソッドは、削除したいオブジェクトのキーを引数として受け取ります。指定されたキーがWeakMap内に存在し、正常に削除された場合はtrueを返し、キーが見つからなかった場合はfalseを返します。なお、WeakMapのキーは必ずオブジェクトである必要があり、文字列や数値などのプリミティブ値はキーとして使用できません。
ガベージコレクションによる自動削除の仕組みがある一方で、deleteメソッドを使うことで、不要になった関連データを即座に解放できます。これにより、特定のオブジェクトが不要になった場合にメモリ効率を向上させ、メモリリークのリスクを低減するために重要な役割を果たします。
構文(syntax)
1const weakMapInstance = new WeakMap(); 2const keyObject = {}; 3weakMapInstance.set(keyObject, 'someValue'); 4weakMapInstance.delete(keyObject);
引数(parameters)
key
- key: any: WeakMap から削除するキー。キーが存在しない場合は何も行われません。
戻り値(return)
boolean
指定されたキーに対応するエントリが WeakMap から正常に削除された場合は true を返します。削除できなかった場合は false を返します。