【JavaScript ECMAScript】Map::Map.prototype.sizeインスタンスアクセサプロパティの使い方

Map.prototype.sizeプロパティは、JavaScriptのMapオブジェクト内に現在格納されているキーと値のペアの数、すなわち要素数を保持するプロパティです。このプロパティは、Mapインスタンスが保持しているエントリーの総数を数値として返します。

Mapオブジェクトにどれだけのデータが格納されているかを確認したい場合に利用されます。例えば、new Map()で新しいMapを作成した直後であればMap.prototype.sizeは0を返します。その後、Map.prototype.set()メソッドを使用して新しいキーと値のペアを追加するたびに、このsizeプロパティの値は自動的に増加します。同様に、Map.prototype.delete()メソッドで要素を削除すると、sizeの値は減少します。

このsizeプロパティは読み取り専用のアクセサープロパティであり、Mapオブジェクトの要素数を直接変更することはできません。要素数の変更は、Mapオブジェクトが提供するset()やdelete()といった専用のメソッドを通じてのみ可能です。返される値は常に0以上の整数であり、Mapの現在の状態を正確に把握するために使用されます。これにより、Mapのデータ量を基にした条件分岐や反復処理などを安全に実装することができます。

Copy
1const mapInstance = new Map();
2mapInstance.set('key1', 'value1');
3mapInstance.set('key2', 'value2');
4const numberOfElements = mapInstance.size;

引数なし

引数はありません

number

Mapオブジェクトに格納されている要素の数を返します。