确定数组的所有成员是否满足指定的测试。

## 语法

~~~

array1.every(callbackfn[, thisArg])

~~~

## 参数

|参数|定义|

|--|--|

|array1|必需。一个数组对象。|

|callbackfn|必需。一个接受最多三个参数的函数。 every 方法会为 array1 中的每个元素调用 callbackfn 函数，直到 callbackfn 返回 false，或直到到达数组的结尾。|

|thisArg|可选。可在 callbackfn 函数中为其引用 this 关键字的对象。如果省略 thisArg，则 undefined 将用作 this 值。|

## 返回值

如果 callbackfn 函数为所有数组元素返回 true，则为 true；否则为 false。如果数组没有元素，则 every 方法将返回 true。

## 异常

如果 callbackfn 参数不是函数对象，则将引发 TypeError 异常。

~~~

ExceptionCondition

~~~

## 备注

every 方法会按升序顺序对每个数组元素调用一次 callbackfn 函数，直到 callbackfn 函数返回 false。如果找到导致 callbackfn 返回 false 的元素，则 every 方法会立即返回 false。否则，every 方法返回 true。

不为数组中缺少的元素调用该回调函数。

除了数组对象之外，every 方法可由具有 length 属性且具有已按数字编制索引的属性名的任何对象使用。

System_CAPS_note注意

可以使用 some 方法 (Array) (JavaScript)检查回调函数是否对数组的任何元素均返回 true。

### 回调函数语法

回调函数的语法如下所示：

~~~

function callbackfn(value, index, array1)

~~~

可使用最多三个参数来声明回调函数。

下表列出了回调函数参数。

|回调参数|定义|

|--|--|

|Value|数组元素的值。|

|index|数组元素的数字索引。|

|array1|包含该元素的数组对象。|

### 修改数组对象

数组对象可由回调函数修改。

下表描述了在 every 方法启动后修改数组对象所获得的结果。

|every 方法启动后的条件|元素是否传递给回调函数|

|--|--|

|在数组的原始长度之外添加元素。|否。|

|添加元素以填充数组中缺少的元素。|是，如果该索引尚未传递给回调函数。|

|元素被更改。|是，如果该元素尚未传递给回调函数。|

|从数组中删除元素。|否，除非该元素已传递给回调函数。|

下面的示例阐释了 every 方法的用法。

~~~

// Define the callback function.

function CheckIfEven(value, index, ar) {

document.write(value + " ");

if (value % 2 == 0)

return true;

else

return false;

}

// Create an array.

var numbers = [2, 4, 5, 6, 8];

// Check whether the callback function returns true for all of the

// array values.

if (numbers.every(CheckIfEven))

document.write("All are even.");

else

document.write("Some are not even.");

// Output:

// 2 4 5 Some are not even.

下面的示例阐释 thisArg 参数的用法，该参数指定对其引用 this 关键字的对象。

JavaScript

// Create a function that returns true if the value is

// numeric and within range.

var checkNumericRange = function(value) {

if (typeof value !== 'number')

return false;

else

return value >= this.minimum && value <= this.maximum;

}

// Create an array of numbers.

var numbers = [10, 15, 19];

// Check whether the callback function returns true for

// all of the array values.

// The obj argument enables use of the this value

// within the callback function.

var obj = { minimum: 10, maximum: 20 }

if (numbers.every(checkNumericRange, obj))

document.write ("All are within range.");

else

document.write ("Some are not within range.");

// Output:

// All are within range.

~~~