Array.prototype.every()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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 为每个数组元素返回真值，则为 true。否则为 false。
描述
every() 方法是一个迭代方法。它为数组中的每个元素调用一次指定的 callbackFn 函数，直到 callbackFn 返回一个假值。如果找到这样的元素，every() 方法将会立即返回 false 并停止遍历数组。否则，如果 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()
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()
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 |
