このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
Array.prototype.values()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2018年5月.
values() はArray インスタンスのメソッドで、配列の各要素の値を含む新しい配列イテレーターオブジェクトを返します。
試してみましょう
const array = ["a", "b", "c"];const iterator = array.values();for (const value of iterator) { console.log(value);}// 予想される結果: "a"// 予想される結果: "b"// 予想される結果: "c"構文
values()引数
なし。
返値
新しい反復可能なイテレーターオブジェクトです。
解説
Array.prototype.values() はArray.prototype[Symbol.iterator]() の既定の実装です。
Array.prototype.values === Array.prototype[Symbol.iterator]; // true疎配列に使用された場合、values() メソッドは空のスロットをundefined の値であるかのように反復処理します。
values() メソッドは汎用的です。このメソッドはthis 値にlength プロパティと整数キーのプロパティがあることだけを期待します。
例
for...of ループを用いた反復処理
values() は反復可能なイテレーターを返すため、for...of ループを使用して反復処理を行うことができます。
const arr = ["a", "b", "c", "d", "e"];const iterator = arr.values();for (const letter of iterator) { console.log(letter);} // "a" "b" "c" "d" "e"next() を使用した反復処理
返値はイテレーターでもあるため、直接next() メソッドを呼び出すことができます。
const arr = ["a", "b", "c", "d", "e"];const iterator = arr.values();iterator.next(); // { value: "a", done: false }iterator.next(); // { value: "b", done: false }iterator.next(); // { value: "c", done: false }iterator.next(); // { value: "d", done: false }iterator.next(); // { value: "e", done: false }iterator.next(); // { value: undefined, done: true }console.log(iterator.next().value); // undefined反復可能オブジェクトの再利用
警告:配列イテレーターオブジェクトは、一回のみ使用可能なオブジェクトになります。再利用しないでください。
values() で返される反復可能オブジェクトは再利用できません。next().done = true またはcurrentIndex > length になった場合、for...of ループは終了し、それ以降の反復処理は効果がありません。
const arr = ["a", "b", "c", "d", "e"];const values = arr.values();for (const letter of values) { console.log(letter);}// "a" "b" "c" "d" "e"for (const letter of values) { console.log(letter);}// undefinedbreak 文を使用して早めに反復処理を終了した場合、反復処理を継続する際にイテレーターで現在の位置から再開することができます。
const arr = ["a", "b", "c", "d", "e"];const values = arr.values();for (const letter of values) { console.log(letter); if (letter === "b") { break; }}// "a" "b"for (const letter of values) { console.log(letter);}// "c" "d" "e"反復処理中の書き替え
values() から返される配列のイテレーターオブジェクトには値が格納されていません。その代わり、生成時に使用した配列のアドレスを格納し、各反復時に現在アクセスしている位置を読み取ります。そのため、イテレーターの出力は、そのステップの実行時にその位置に格納されている値に依存します。配列の値が変化した場合は、配列イテレーターオブジェクトの値も変化します。
const arr = ["a", "b", "c", "d", "e"];const iterator = arr.values();console.log(iterator); // Array Iterator { }console.log(iterator.next().value); // "a"arr[1] = "n";console.log(iterator.next().value); // "n"反復処理メソッドとは異なり、配列イテレーターオブジェクトは作成時に配列の長さを保存せず、反復処理のたびに一度だけ読み込みます。そのため、反復処理中に配列が大きくなった場合、イテレーターは新しい要素も処理します。これにより、無限ループが発生する可能性があります。
const arr = [1, 2, 3];for (const e of arr) { arr.push(e * 10);}// RangeError: invalid array length疎配列の反復処理
values() は空のスロットをundefined であるかのように処理します。
for (const element of [, "a"].values()) { console.log(element);}// undefined// 'a'配列以外のオブジェクトに対する values() の呼び出し
values() メソッドはthis のlength プロパティを読み込み、そのキーがlength より小さい非負の整数である各プロパティにアクセスします。
const arrayLike = { length: 3, 0: "a", 1: "b", 2: "c", 3: "d", // length が 3 であるため values() からは無視される};for (const entry of Array.prototype.values.call(arrayLike)) { console.log(entry);}// a// b// c仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.values |