values() メソッドは、配列の各インデックスの値を含む新しい Array Iterator オブジェクトを返します。

var a = ['a', 'b', 'c', 'd', 'e']; 
var iterator = a.values();

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

構文

arr.values()

戻り値

新しい Array iterator オブジェクトです。

for...of ループを用いる反復

var arr = ['a', 'b', 'c', 'd', 'e'];
var iterator = arr.values();

for (let letter of iterator) {
  console.log(letter);
}

Array.prototype.values は Array.prototype[Symbol.iterator] の既定の実装です。

Array.prototype.values === Array.prototype[Symbol.iterator]      //true

仕様

仕様書 状況 コメント
ECMAScript 2015 (6th Edition, ECMA-262)
Array.prototype.values の定義
標準 初期定義。
ECMAScript Latest Draft (ECMA-262)
Array.prototype.values の定義
ドラフト  

ブラウザー実装状況

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
valuesChrome 完全対応 66Edge 完全対応 12Firefox 完全対応 60IE 未対応 なしOpera 完全対応 53Safari 完全対応 9WebView Android 完全対応 66Chrome Android 完全対応 66Firefox Android 完全対応 60Opera Android 完全対応 47Safari iOS 完全対応 9Samsung Internet Android 未対応 なしnodejs 完全対応 10.9.0
完全対応 10.9.0
完全対応 6.5.0
補足 無効
補足 The --harmony-array-prototype-values flag is required; the --harmony flag is not sufficient in this case.
無効 From version 6.5.0: this feature is behind the --harmony-array-prototype-values runtime flag.
未対応 0.12 — 4.0.0

凡例

完全対応  
完全対応
未対応  
未対応
実装ノートを参照してください。
実装ノートを参照してください。
ユーザーが明示的にこの機能を有効にしなければなりません。
ユーザーが明示的にこの機能を有効にしなければなりません。

関連情報

ドキュメントのタグと貢献者

最終更新者: mdnwebdocs-bot,