every()
方法测试一个数组内的所有元素是否都能通过指定函数的测试。它返回一个布尔值。
every()
方法测试一个数组内的所有元素是否都能通过指定函数的测试。它返回一个布尔值。
const isBelowThreshold = (currentValue) => currentValue < 40;
const array1 = [1, 30, 39, 29, 10, 13];
console.log(array1.every(isBelowThreshold));
/ Expected output: true
every(callbackFn)
every(callbackFn, thisArg)
callbackFn
为数组中的每个元素执行的函数。它应该返回一个假值。该函数被调用时将传入以下参数:
thisArg
可选执行 callbackFn
时用作 this
的值。参见迭代方法。
如果 callbackFn
为每个数组元素返回真值,every()
就会返回 true
。
every
和数学中的全称量词"任意(∀)"类似。特别的,对于空数组,它只返回 true
。(这种情况属于空集的所有元素都符合给定的条件。)
callbackFn
仅针对已分配值的数组索引调用。它不会为稀疏数组中的空槽调用。
every()
不会改变调用它的数组,但指定的 callbackFn
函数可以。但是请注意,数组的长度是在第一次调用 callbackFn
之前保存的。所以:
every()
时,callbackFn
将不会访问超出数组初始长度的任何元素。callbackFn
。callbackFn
更改,则它传递给 callbackFn
的值将是该元素被修改后的值。被删除的元素则不会被访问。警告: 上述类型的并发修改经常导致难以理解的代码,通常应避免(特殊情况除外)。
every()
方法是通用的。它只期望 this
值具有 length
属性和整数键属性。
下例测试数组中的所有元素是否都大于 10。
function isBigEnough(element, index, array) {
return element >= 10;
}
[12, 5, 8, 130, 44].every(isBigEnough); / false
[12, 54, 18, 130, 44].every(isBigEnough); / true
下面的示例测试一个数组的所有元素是否都存在于另一个数组中。
const isSubset = (array1, array2) =>
array2.every((element) => array1.includes(element));
console.log(isSubset([1, 2, 3, 4, 5, 6, 7], [5, 7, 6])); / true
console.log(isSubset([1, 2, 3, 4, 5, 6, 7], [5, 8, 7])); / false
every()
不会在空槽上运行它的断言函数。
console.log([1, , 3].every((x) => x !== undefined)); / true
console.log([2, , 2].every((x) => x === 2)); / true
以下示例测试修改数组时 every
方法的行为。
/ --------------
/ 修 改 元 素
/ --------------
let arr = [1, 2, 3, 4];
arr.every((elem, index, arr) => {
arr[index + 1]--;
console.log(`[${arr}][${index}] -> ${elem}`);
return elem < 2;
});
/ 循环会迭代 3 次
/ 没有修改的情况下只会迭代 2 次
/
/ 第 1 次迭代:[1,1,3,4][0] -> 1
/ 第 2 次迭代:[1,1,2,4][1] -> 1
/ 第 3 次迭代:[1,1,2,3][2] -> 2
/ --------------
/ 添 加 元 素
/ --------------
arr = [1, 2, 3];
arr.every((elem, index, arr) => {
arr.push("new");
console.log(`[${arr}][${index}] -> ${elem}`);
return elem < 4;
});
/ 循环迭代 3 次,即使在添加新元素之后
/
/ 第 1 次迭代:[1, 2, 3, new][0] -> 1
/ 第 2 次迭代:[1, 2, 3, new, new][1] -> 2
/ 第 3 次迭代:[1, 2, 3, new, new, new][2] -> 3
/ --------------
/ 删 除 元 素
/ --------------
arr = [1, 2, 3, 4];
arr.every((elem, index, arr) => {
arr.pop();
console.log(`[${arr}][${index}] -> ${elem}`);
return elem < 4;
});
/ 循环仅迭代 2 次
/ 因为剩余的元素被 `pop()` 删除
/
/ 第 1 次迭代:[1,2,3][0] -> 1
/ 第 2 次迭代:[1,2][1] -> 2
every()
方法读取 this
的 length
属性,然后访问每个整数索引,直到到达末尾或 callbackFn
返回 false
。
const arrayLike = {
length: 3,
0: "a",
1: "b",
2: "c",
};
console.log(
Array.prototype.every.call(arrayLike, (x) => typeof x === "string"),
); / true
Specification |
---|
ECMAScript® 2026 Language Specification # sec-array.prototype.every |