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 May 2018.
values() 方法返回一个新的数组迭代器对象，该对象迭代数组中每个元素的值。
尝试一下
const array1 = ["a", "b", "c"]; const iterator = array1.values(); for (const value of iterator) { console.log(value); } // Expected output: "a" // Expected output: "b" // Expected output: "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); } // undefined 如果使用 break 语句提前结束迭代，当继续迭代时，迭代器可以从当前位置恢复迭代。
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" 迭代稀疏数组
values() 会访问空槽并将其视为 undefined。
for (const element of [, "a"].values()) { console.log(element); } // undefined // 'a' 在非数组对象上调用 values()
values() 方法读取 this 的 length 属性，然后访问每个整数索引。
const arrayLike = { length: 3, 0: "a", 1: "b", 2: "c", }; for (const entry of Array.prototype.values.call(arrayLike)) { console.log(entry); } // a // b // c 规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.values |
