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 以降でサポート

関連メソッド

仕様

  • ECMAScript 2015 (ECMA-262)
カテゴリ:JavaScript
カテゴリ:JavaScript