【JavaScript ECMAScript】Map::Map.prototype.valuesインスタンスメソッドの使い方

Map.prototype.values()メソッドは、Mapオブジェクトに格納されているすべての値（value）を、挿入された順序で新しいイテレーターとして返すメソッドです。

このメソッドを呼び出すと、Mapオブジェクトが保持している各キーに対応する値のみを順番に取り出すことができます。返されるイテレーターは、ES2015で導入されたイテレーションプロトコルに準拠しており、for...ofループやスプレッド構文（...）を使用して簡単に展開し、各値にアクセスできます。また、イテレーターのnext()メソッドを呼び出すことで、一度に一つずつ値を取得することも可能です。

Mapオブジェクトが空の場合、このメソッドは要素を持たない空のイテレーターを返します。このメソッドは元のMapオブジェクトの内容を変更することなく、非破壊的に値を抽出します。Mapオブジェクトから値だけを処理したい場合や、値のコレクションを作成したい場合に非常に役立ちます。

Mapオブジェクトのキーと値を両方取得したい場合はMap.prototype.entries()メソッドを、キーのみを取得したい場合はMap.prototype.keys()メソッドを使用します。Map.prototype.values()は、特にMapの「値」側に関心がある場合に最適な方法を提供します。

Copy
1const myMap = new Map();
2myMap.set('name', 'Alice');
3myMap.set('age', 30);
4
5const mapValuesIterator = myMap.values();

引数なし

引数はありません

MapIterator

Map オブジェクトの各エントリに対応する値のイテレータを返します。このイテレータは、Map オブジェクトの要素を順番にたどるために使用できます。