【Node.js24.x】Map::length定数の使い方
length定数の使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
length定数は、Node.js環境で利用可能な組み込みのMapクラスのコンストラクタが、初期化時に受け取ることを想定している仮引数の数を表す定数です。Mapコンストラクタは、new Map([iterable])のように、キーと値のペアを持つ反復可能なオブジェクト（例えば、[[key1, value1], [key2, value2]]のような配列の配列）をたった一つだけ引数として受け入れることができます。このため、Map.lengthの値は常に1となります。
このlength定数は、Mapインスタンスが実際に格納している要素の数を示すものではありません。Mapインスタンスに現在いくつのエントリ（キーと値のペア）が追加されているかを知りたい場合は、そのMapオブジェクトのsizeプロパティ（例: myMap.size）を参照する必要があります。Map.lengthは、JavaScriptの他の組み込みコンストラクタ（例: Array.lengthも1）と同様に、コンストラクタが期待する引数の数を宣言する目的で提供されます。一般的なアプリケーション開発で直接この定数を参照することは稀ですが、JavaScriptエンジンの内部動作の理解や、高度なメタプログラミングの文脈で役立つことがあります。
構文(syntax)
1console.log(Map.length);
引数(parameters)
引数なし
引数はありません
戻り値(return)
number
Mapオブジェクトに格納されている要素の数を示します。