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() 方法返回一个新的数组迭代器对象，该对象迭代数组中每个元素的值。

尝试一下

语法

js
values()

返回值

一个新的可迭代迭代器对象。

描述

Array.prototype.values() 是 Array.prototype[Symbol.iterator]() 的默认实现。

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

当应用于稀疏数组时，values() 方法会将空槽作为 undefined 迭代。

values() 方法是通用的。它只需要 this 值具有 length 属性和整数键属性。

示例

使用 for...of 循环进行迭代

由于 values() 返回一个可迭代迭代器对象，你可以使用 for...of 循环来迭代它。

js
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() 方法。

js
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 循环结束，进一步迭代它没有任何效果。

js
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 语句提前结束迭代，当继续迭代时，迭代器可以从当前位置恢复迭代。

js
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() 返回的数组迭代器对象中没有存储任何值；但是它存储了用于创建它的数组的地址，并在每次迭代中读取当前访问的索引。因此，它的迭代输出取决于在迭代时存储在该索引中的值。如果数组中的值发生了改变，数组迭代器对象的值也会改变。

js
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。

js
for (const element of [, "a"].values()) {
  console.log(element);
}
// undefined
// 'a'

在非数组对象上调用 values()

values() 方法读取 this 的 length 属性，然后访问每个整数索引。

js
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 Language Specification
# sec-array.prototype.values

浏览器兼容性

BCD tables only load in the browser

参见