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

entriesメソッドは、配列の各要素に対して、その要素のインデックスと値のペアを順に取り出すためのイテレータを返すメソッドです。このメソッドは、呼び出された配列の各インデックスと、そのインデックスに対応する値をペアとして含んだ新しいイテレータオブジェクトを生成し、返します。

返されるイテレータオブジェクトは、ECMAScript 2015で導入されたイテレーションプロトコルに準拠しており、next()メソッドを持っています。このnext()メソッドを呼び出すたびに、配列の次の要素に対応する[インデックス, 値]のペアが、{ value: [インデックス, 値], done: false }という形式のオブジェクトとして返されます。配列のすべての要素が取得し終わると、{ value: undefined, done: true }が返され、イテレーションが完了したことを示します。

entriesメソッドは、特にfor...ofループと組み合わせて使用することで、配列のインデックスと要素の値を同時に簡単に取得できるため、配列の要素を一つずつ、その位置情報と共に処理する際に非常に役立ちます。例えば、for (const [index, element] of array.entries())のような形で利用できます。元の配列の内容がこのメソッドによって変更されることはなく、非破壊的な操作です。

Copy
1const items = ['apple', 'banana', 'orange'];
2for (const entry of items.entries()) {
3  console.log(entry);
4}

引数なし

引数はありません

Array Iterator

Array.prototype.entries() メソッドは、配列の各要素とそのインデックスのペアを格納したイテレータオブジェクトを返します。このイテレータは、[index, element] の形式で各要素を順番に取得できます。