大网数据广告活动
Web 标准与前端开发

Iterator.prototype.take()

· 52CE 我爱测

Iterator 实例的 **`take()`** 方法返回一个新的迭代器辅助方法,该迭代器辅助方法生成此迭代器中给定数量的元素,然后终止。

Iterator 实例的 take() 方法返回一个新的迭代器辅助方法,该迭代器辅助方法生成此迭代器中给定数量的元素,然后终止。

语法

take(limit)

参数

  • limit
    • : 要从迭代器的开头获取的元素数量。

返回值

一个新的迭代器辅助方法。返回的迭代器辅助方法逐个生成原始迭代器中的元素,并在生成 limit 个元素后(或原始迭代器耗尽时)完成(next() 方法产生 { value: undefined, done: true })。

异常

  • RangeError

示例

使用 take()

下面的示例创建了一个生成斐波那契数列中的项的迭代器,然后打印前三个项:

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

const seq = fibonacci().take(3);
console.log(seq.next().value); // 1
console.log(seq.next().value); // 1
console.log(seq.next().value); // 2
console.log(seq.next().value); // undefined

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

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

for (const n of fibonacci().take(5)) {
  console.log(n);
}

// 输出:
// 1
// 1
// 2
// 3
// 5

因为 fibonacci() 是一个无限迭代器,你无法直接使用 for 循环来迭代它。

将 drop() 与 take() 结合使用

你可以将 take() 与 Iterator.prototype.drop() 结合使用来获取迭代器的切片:

for (const n of fibonacci().drop(2).take(5)) {
  // 丢弃第一个元素,然后取接下来的五个元素
  console.log(n);
}
// 输出:
// 2
// 3
// 5
// 8
// 13

for (const n of fibonacci().take(5).drop(2)) {
  // 取前五个元素,然后丢弃其中的前两个元素
  console.log(n);
}
// 输出:
// 2
// 3
// 5

获取元素数量的下限和上限

当 limit 为负数或 NaN 时,会抛出 RangeError 异常:

fibonacci().take(-1); // RangeError: -1 must be positive
fibonacci().take(undefined); // RangeError: undefined must be positive

当 limit 大于该迭代器可生成的元素总数时(比如 Infinity),返回的迭代器辅助方法的行为与原始迭代器基本相同:

for (const n of new Set([1, 2, 3]).values().take(Infinity)) {
  console.log(n);
}

// 输出:
// 1
// 2
// 3

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。