30 seconds of code:用 `Array.prototype.every()` 检查 JavaScript 数组中所有值是否相等

原创2026-09-30 09:39:161,814 阅读
文章标签:教程文档

30 seconds of code:用 Array.prototype.every() 检查 JavaScript 数组中所有值是否相等

判断数组中所有元素是否相等,是前端开发中高频出现的数据校验需求。本文基于 30 seconds of code 仓库的 all-values-of-array-are-equal.md 文档,从「首元素参照」的核心思路出发,给出 allEqual 与支持映射函数的 allEqualBy 两个可直接复用的实现,并结合仓库内其他数组相关文章与 ECMAScript 规范,深入剖析 every() 的短路求值、空数组行为与对象数组等复杂场景。读完本文,你将掌握一套从简单值到复杂对象全覆盖的「数组全等判断」实战方案。

核心思路:以首元素为参照,用 every() 逐项比对

检查数组中所有元素是否相等,本质上就是「让每个元素都通过同一条件」。Array.prototype.every() 恰好就是为这种场景设计的:它遍历数组并对每个元素执行回调,只有所有元素都返回真值时才返回 true,一旦遇到返回假值的元素就会立即短路返回 false。

既然要让所有元素相等,最自然的参照物就是数组的第一个元素:把 arr[0] 作为基准,其余每个元素与它做严格相等(===)比较即可。

const allEqual = arr => arr.every(val => val === arr[0]);

allEqual([1, 1, 1]); // true
allEqual([1, 1, 2]); // false

这段代码有两个值得注意的细节:

  • 使用 === 严格相等:与 == 宽松相等不同,=== 不会触发类型转换,因此 1 与 '1'、0 与 false 会被判定为不相等,避免了隐式转换带来的误判。
  • 复杂度为 O(n):every() 在最坏情况下遍历完整数组,但一旦发现不匹配元素立即停止,实际开销通常远低于全量遍历。

进阶:用映射函数处理对象与复杂值

直接比较值只能应对数字、字符串等原始类型。当数组元素是对象时,=== 比较的是引用而非内容——{ a: 1 } 与另一个 { a: 1 } 是两个不同引用,直接比较永远返回 false。此时就需要引入一个映射函数(mapping function),先对每个元素做一次投影,再比较投影结果。

实现方式与基础版如出一辙:对第一个元素调用映射函数得到基准值,其余元素分别调用映射函数后与之比较。回调的第三个参数(原数组)一并传入,便于映射函数在需要时访问上下文。

const allEqualBy = (arr, fn) =>
  arr.every((val, i) => fn(val, i, arr) === fn(arr[0], 0, arr));

allEqualBy([{ a: 1 }, { a: 1 }, { a: 1 }], obj => obj.a); // true
allEqualBy([{ a: 1 }, { a: 1 }, { a: 2 }], obj => obj.a); // false

allEqualBy 的应用面比基础版宽得多,例如:

  • 按对象属性判断:allEqualBy(users, u => u.role) 可校验一个用户数组是否全部属于同一角色;
  • 按计算结果判断:allEqualBy(items, x => x.price * x.quantity) 可判断总价是否一致;
  • 按嵌套路径判断:allEqualBy(orders, o => o.customer.id) 可判断订单是否来自同一位客户。

注意,映射函数会在每次比较时重复调用。若映射逻辑较重(如深层嵌套遍历、复杂计算),可先 arr.map(fn) 得到投影数组再交给 allEqual,用一次遍历换取可读性。

空数组与真值检查:两个必须知道的边界

every() 对空数组返回 true

当你调用 allEqual(<a href="https://link.gitcode.com/i/f6d2ef1999a22762b9811ec577fb1d3a" target="_blank">]) 时,结果不是报错而是 true。这一行为源于数学中的空真(vacuous truth):every() 等价于全称量词 "for all",对空集而言,任何命题都"无条件成立"。仓库中的 [empty-array-every-some.md 一文专门剖析了这一现象——它用 for 循环类比解释了 every 的默认结果为 true(没有元素返回 false),并指出其姊妹方法 some() 对空数组返回 false(等价于存在量词 "there exists")。

在工程实践中这意味着:使用 allEqual 之前应先判断数组长度,或自行决定空数组的语义(例如视作"相等"并返回 true,或视为无效输入提前返回 false),避免静默通过校验。

真值检查与全等检查是两回事

仓库中的 check-array-values-are-truthy.md 展示了 every()/some() 的另一种常见用法——检查数组是否全为真值:

const all = (arr, fn = Boolean) => arr.every(fn);

all([4, 2, 3], x => x > 1); // true
all([1, 2, 3]);             // true

这里的 Boolean 作为默认回调,判断的是"真/假",与 allEqual 判断的"相等"语义不同:allEqual([1, 1, 1]) 关注元素间关系,all([1, 1, 1]) 关注元素本身的真假。二者互补,可按需选择。

底层原理:every() 的规范行为与短路求值

从 ECMAScript 规范(Array.prototype.every)看,every() 的执行步骤本质上等价于:

const every = (arr, predicate) => {
  for (const val of arr)
    if (!predicate(val)) return false;
  return true;
};

也就是说,every() 是一个短路求值的迭代器:任何一次回调返回假值,遍历立即终止并返回 false;只有完整遍历结束才会返回 true。这正是 allEqual 在 [1, 1, 2] 这类数组上比 [2, 1, 1] 更快的原因——不匹配元素越靠前,越早结束。

另外需要注意,every() 会跳过稀疏数组中的空槽位(for...of 不会跳过,但 every 规范明确跳过 undefined 槽位)。若数组由 new Array(n) 或稀疏字面量创建,allEqual 会返回 true 而不会逐项比较,这符合"空槽不参与比较"的语义。

关联阅读:仓库中的数组比较工具箱

本主题与仓库中其他数组文章构成一个完整的"比较体系",可互相参照:

需求 方案文档 关键手段
数组内所有值相等(本文) all-values-of-array-are-equal.md every() + 首元素参照
数组内全为真值/假值 check-array-values-are-truthy.md every() / some() + Boolean
两个数组内容相同(忽略顺序) arrays-have-same-contents.md Set + 频次统计
两个数组元素逐位相等 array-comparison.md 长度校验 + every()
数组满足一个/全部条件 array-has-only-one-match-or-many.md filter().length 计数
空数组上的 every() / some() empty-array-every-some.md 空真原理

这些文章共同揭示了 every() 的两个关键特性——"以首元素/首对象为基准的全量校验"与"空数组返回 true 的空真语义",掌握它们,JavaScript 数组条件校验的大多数场景都能轻松覆盖。

小结

判断数组元素是否全部相等,核心只有三步:确定参照(首元素或首元素的映射结果)、逐项比较(every() 严格相等)、处理边界(空数组与对象引用)。本文的两个实现 allEqual 与 allEqualBy 分别覆盖原始值数组与对象数组,代码简短、可直接复制进生产项目。如需更深一层的理解,推荐继续阅读仓库中的 empty-array-every-some.md 与 check-array-values-are-truthy.md,它们从规范与工程两个角度补齐了 every() 的完整图景。

登录后查看全文
30-seconds-of-code