JavaScript Array every() 方法

定义和用法

every() 方法检查数组中的所有元素是否都通过了测试（被作为函数提供）。

every() 方法对数组中存在的每个元素执行一次函数：

  • 如果找到函数返回 false 值的数组元素，every() 返回 false（并且不检查剩余值）
  • 如果没有出现 false，every() 返回 true

注释：every() 不对没有值的数组元素执行函数。

注释：every() 不改变原始数组。

实例

例子 1

检查 age 数组中的所有值是否都为 18 或以上：

var ages = [32, 33, 16, 40];

function checkAdult(age) {
  return age >= 18;
}

function myFunction() {
  document.getElementById("demo").innerHTML = ages.every(checkAdult);
}

亲自试一试

例子 2

检查 ages 数组中的所有值是否为或超过特定数字：

<p>Minimum age: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Try it</button>

<p>All ages above minimum? <span id="demo"></span></p>

<script>
var ages = [32, 33, 12, 40];

function checkAdult(age) {
  return age >= document.getElementById("ageToCheck").value;
}

function myFunction() {
  document.getElementById("demo").innerHTML = ages.every(checkAdult);
}
</script>

亲自试一试

例子 3

检查数组中的所有 answer 值是否相同：

<script>
var survey = [
  { name: "Steve", answer: "Yes"},
  { name: "Jessica", answer: "Yes"},
  { name: "Peter", answer: "Yes"},
  { name: "Elaine", answer: "No"}
];

function isSameAnswer(el, index, arr) {
  if (index === 0){
    return true;
  } else {
    return (el.answer === arr[index - 1].answer);
  }
}

function myFunction() {
  document.getElementById("demo").innerHTML = survey.every(isSameAnswer);
}
</script>

亲自试一试

浏览器支持

所有浏览器都完全支持 every() 方法：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
支持 9.0 支持 支持 支持 支持

语法

array.every(function(currentValue, index, arr), thisValue)

参数值

参数 描述
function(currentValue, index, arr) 必需。为数组中的每个元素运行的函数。

函数参数：

参数 描述
currentValue 必需。当前元素的值。
index 可选。当前元素的数组索引。
arr 可选。当前元素所属的数组对象
thisValue

可选。要传递给函数以用作其 "this" 值的值。

如果此参数为空，则值 "undefined" 将作为其 "this" 值传递。

技术细节

返回值： 布尔值。如果数组中的所有元素都通过测试，则返回 true，否则返回 false.
JavaScript 版本： ECMAScript 5

相关页面

教程：JavaScript 数组

教程：JavaScript 数组 Const

教程：JavaScript 数组方法

教程：JavaScript 排序数组

教程：JavaScript 数组迭代