Iterator.prototype.every()

基准线 2025
新推出

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

every() 方法与 Array.prototype.every() 类似:它测试由迭代器生成的所有元素是否都通过了提供的函数实现的测试。它返回一个布尔值。

语法

js
every(callbackFn)

参数

callbackFn

一个用于执行迭代器产生的每个元素的函数。它应该返回一个真值以指示元素通过测试,否则返回一个假值。该函数以以下参数调用:

element

正在处理的当前元素。

index

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

返回值

如果 callbackFn 为每个元素都返回一个真值,则返回 true。否则,返回 false

描述

every() 迭代迭代器,并为每个元素调用一次 callbackFn 函数。如果回调函数返回一个假值,它会立即返回 false。否则,它将迭代直到迭代器结束并返回 true。如果 every() 返回 false,则通过调用其 return() 方法来关闭底层迭代器。

迭代器辅助函数相较于数组方法的主要优势在于它们是惰性的,这意味着它们只在需要时才生成下一个值。这避免了不必要的计算,并且也允许它们与无限迭代器一起使用。对于无限迭代器,every() 会在找到第一个假值后立即返回 false。如果 callbackFn 始终返回真值,则该方法永远不会返回。

示例

使用 every()

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().every(isEven)); // false

const isPositive = (x) => x > 0;
console.log(fibonacci().take(10).every(isPositive)); // true
console.log(fibonacci().every(isPositive)); // Never completes

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

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

规范

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

浏览器兼容性

另见