Iterator.prototype.map()

Baseline 2025
Newly available

Since March 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

实验性: 这是一项实验性技术
在将其用于生产之前，请仔细检查浏览器兼容性表格。

Iterator 实例的 map() 方法返回一个新的迭代器辅助方法，该方法生成由映射函数转换后的迭代器的元素。

语法

js
map(callbackFn)

参数

callbackFn

为迭代器中的每个元素执行的函数。其返回值将由迭代器辅助方法生成。该函数被调用时将传入以下参数：

element

当前正在处理的元素。

index

正在处理的当前元素的索引。

返回值

一个新的迭代器辅助方法。每当迭代器辅助方法的 next() 方法被调用时，它从底层迭代器中获取下一个元素，调用 callbackFn，并产生返回值。当底层迭代器完成时，迭代器辅助方法也会完成（next() 方法产生 { value: undefined, done: true }）。

描述

迭代器辅助方法相对于数组方法的主要优势在于它们能够处理无限迭代器。对于无限迭代器，map() 允许你创建一个新的迭代器，该迭代器在迭代时产生经过转换的元素。

示例

使用 map()

下面的示例创建了一个生成斐波那契数列中的项的迭代器，并将其转换为每个项的平方的新迭代器，然后读取前几个项：

js
function* fibonacci() {
  let current = 1;
  let next = 1;
  while (true) {
    yield current;
    [current, next] = [next, current + next];
  }
}

const seq = fibonacci().map((x) => x ** 2);
console.log(seq.next().value); // 1
console.log(seq.next().value); // 1
console.log(seq.next().value); // 4

在 for...of 循环中使用 map()

当你不想手动迭代迭代器时，map() 是最方便的。因为迭代器也是可迭代的，所以你可以用 for...of 循环来迭代返回的辅助方法：

js
for (const n of fibonacci().map((x) => x ** 2)) {
  console.log(n);
  if (n > 30) {
    break;
  }
}

// 输出：
// 1
// 1
// 4
// 9
// 25
// 64

等价于：

js
for (const n of fibonacci()) {
  const n2 = n ** 2;
  console.log(n2);
  if (n2 > 30) {
    break;
  }
}

规范

Specification
Iterator Helpers
# sec-iteratorprototype.map

浏览器兼容性

参见