JavaScript Guidebook

JavaScript 完全知识体系

Array.prototype.every()

every() 方法遍历数组中每个成员,通过回调函数判断是否所有成员都满足特定条件。

语法

语法:

arr.every( predicate [, thisArg ] )

类型声明:

interface Array<T> {
every<S extends T>(
predicate: (value: T, index: number, array: T[]) => value is S,
thisArg?: any
): this is S[];
every(predicate: (value: T, index: number, array: T[]) => unknown, thisArg?: any): boolean;
}

参数说明:

参数说明类型
predicate用于判定数组成员的回调函数function
thisArg执行回调函数的 this

callback 函数的参数:

  • currentValue:当前数组中处理的元素
  • index:数组中正处理的当前元素的索引
  • array:被调用的数组

返回值:

返回当所有数组元素满足回调函数的判断时返回 true,否则返回 false

方法说明

  • 执行该方法会为数组每个成员执行一次回调函数,回调函数需要通过判断代码块后,返回布尔值作为该成员是否通过检测的凭证,如果通过则再为下一个数组成员执行回调函数,直到遇到第一个判断为 false 的数组成员则立即给实例方法返回 false,否则全部成员都通过检测的回调函数,则返回 true
  • 回调函数只会为那些已经被赋值的索引调用,不会为那些被删除或从来没有被赋值的索引调用。
  • 如果为实例方法提供一个 thisArg 参数,则该参数为调用回调函数时的 this 值。如果省略该参数,则为回调函数被调用时的 this 值,在非严格模式下为全局对象,在严格模式下传入 undefined
  • 遍历的数组成员范围在第一次调用回调函数之前就已确定了。在调用 every() 之后添加到数组中的成员不会被回调函数访问到。如果数组中存在的成员被更改,则他们传入回调函数的值是 every() 访问到他们那一刻的值。那些被删除的成员或未被赋值的成员将不会被访问到。

代码示例

下例检测数组中的所有元素是否都大于 10。

const isBigEnough = (element, index, array) =>
(element >= 10)[(12, 5, 8, 130, 44)].every(isBigEnough)[
// false
(12, 54, 18, 130, 44)
].every(isBigEnough);
// true

参考资料