Iterator.prototype.find()

基准线 2025
新推出

自 ⁨2025 年 3 月⁩ 起,此功能可在最新的设备和浏览器版本上使用。此功能可能在旧设备或浏览器上无法正常工作。

find() 方法与 Array.prototype.find() 类似:它会返回迭代器产生的第一个满足指定测试函数的元素。如果没有值满足测试函数,则返回 undefined

语法

js
find(callbackFn)

参数

callbackFn

一个为迭代器产生的每个元素执行的函数。它应该返回一个 truthy 值来指示已找到匹配的元素,否则返回一个 falsy 值。该函数会以下列参数调用:

element

正在处理的当前元素。

index

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

返回值

迭代器产生的第一个满足指定测试函数的元素。否则,将返回 undefined

描述

find() 会迭代迭代器,并为每个元素调用一次 callbackFn 函数。如果回调函数返回一个 truthy 值,则会立即返回该元素。否则,它将一直迭代到迭代器末尾并返回 undefined。如果 find() 返回一个元素,则通过调用其 return() 方法来关闭底层迭代器。

迭代器助手相对于数组方法的主要优点是它们是惰性的,这意味着它们仅在需要时才生成下一个值。这避免了不必要的计算,并且还允许它们与无限迭代器一起使用。对于无限迭代器,find() 会在找到第一个满足条件的元素后立即返回。如果 callbackFn 始终返回一个 falsy 值,则该方法将永远不会返回。

示例

使用 find()

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

const isEven = (x) => x % 2 === 0;
console.log(fibonacci().find(isEven)); // 2

const isNegative = (x) => x < 0;
console.log(fibonacci().take(10).find(isNegative)); // undefined
console.log(fibonacci().find(isNegative)); // Never completes

调用 find() 总是会关闭底层迭代器,即使该方法提前返回。迭代器永远不会处于半途状态。

js
const seq = fibonacci();
console.log(seq.find(isEven)); // 2
console.log(seq.next()); // { value: undefined, done: true }

规范

规范
ECMAScript® 2026 语言规范
# sec-iterator.prototype.find

浏览器兼容性

另见