Iterator.prototype.find()
find() 方法与 Array.prototype.find() 类似:它会返回迭代器产生的第一个满足指定测试函数的元素。如果没有值满足测试函数,则返回 undefined。
语法
js
find(callbackFn)
参数
callbackFn-
一个为迭代器产生的每个元素执行的函数。它应该返回一个 truthy 值来指示已找到匹配的元素,否则返回一个 falsy 值。该函数会以下列参数调用:
返回值
迭代器产生的第一个满足指定测试函数的元素。否则,将返回 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 |
浏览器兼容性
加载中…