Iterator.prototype.find()
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 实例的 find() 方法与 Array.prototype.find() 类似：它返回迭代器生成的第一个满足提供的测试函数的元素。如果没有值满足测试函数，则返回 undefined。
语法
js
find(callbackFn)
参数
callbackFn-
为迭代器中的每个元素执行的函数。它应该返回一个真值来表示找到了一个匹配的元素，否则返回一个假值。该函数被调用时将传入以下参数：
返回值
迭代器生成的第一个满足提供的测试函数的元素。如果没有值满足测试函数，则返回 undefined。
描述
find() 迭代该迭代器并对每个元素调用一次 callbackFn 函数。如果 callbackFn 函数返回一个真值，则立即返回该元素。否则，它会一直迭代到迭代器的末尾，并返回 undefined。如果 find() 返回了一个元素，则会调用底层迭代器的 return() 方法来关闭它。
迭代器辅助方法相对于数组方法的主要优势在于它们能够处理无限迭代器。对于无限迭代器，find() 会在找到第一个满足元素时立即返回。如果 callbackFn 始终返回假值，则该方法永远不会返回。
示例
使用 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)); // 永远不会完成
调用 find() 总是关闭底层迭代器，即使该方法提前返回。迭代器永远不会处于中间状态。
js
const seq = fibonacci();
console.log(seq.find(isEven)); // 2
console.log(seq.next()); // { value: undefined, done: true }
规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-iterator.prototype.find |