JavaScript/Array/prototype/values

Array.prototype.values()

Array.prototype.values() は、配列の要素を反復処理するためのイテレータを返すメソッドです。

構文

array.values()

返り値

配列の要素を順次返す Iterator オブジェクト

説明

• 配列の各要素を順番に取得できるイテレータを生成
• 元の配列を変更せずに反復処理が可能
• ECMAScript 2015 (ES6) で導入されたメソッド

使用例

基本的な使用

const array = ['a', 'b', 'c'];
const iterator = array.values();

console.log(iterator.next().value); // 'a'
console.log(iterator.next().value); // 'b'
console.log(iterator.next().value); // 'c'

for...of ループでの使用

const array = [1, 2, 3];
for (const value of array.values()) {
    console.log(value); // 1, 2, 3 を順に出力
}

スプレッド構文との併用

const array = ['x', 'y', 'z'];
const values = [...array.values()];
console.log(values); // ['x', 'y', 'z']

注意点

• イテレータは一度しか使用できません
• 新しい配列を生成するわけではありません
• 空の配列に対しては空のイテレータを返します

ブラウザ互換性

• モダンブラウザで広くサポート
• Internet Explorer では利用不可
• Node.js 4.0.0 以降でサポート

関連メソッド

• Array.prototype.keys()
• Array.prototype.entries()

仕様

• ECMAScript 2015 (ECMA-262)