JavaScript Array every() 方法

Array 對象參考手冊 JavaScript Array 對象

實例

檢測數組 ages 的所有元素是否都大於等於 18 :

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

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

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

輸出結果為:

false

定義和用法

every() 方法用於檢測數組所有元素是否都符合指定條件（通過函數提供）。

every() 方法使用指定函數檢測數組中的所有元素：

  • 如果數組中檢測到有一個元素不滿足，則整個運算式返回 false ，且剩餘的元素不會再進行檢測。
  • 如果所有元素都滿足條件，則返回 true。

注意： every() 不會對空數組進行檢測。

注意： every() 不會改變原始數組。

流覽器支持

表格中的數字表示支持該方法的第一個流覽器的版本號。

方法
every() Yes 9 1.5 Yes Yes

語法

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

參數說明

參數 描述
function(currentValue, index,arr) 必須。函數，數組中的每個元素都會執行這個函數
函數參數:
參數 描述
currentValue 必須。當前元素的值
index 可選。當前元素的索引值
arr 可選。當前元素屬於的數組對象
thisValue 可選。對象作為該執行回調時使用，傳遞給函數，用作 "this" 的值。
如果省略了 thisValue ，"this" 的值為 "undefined"

技術細節

返回值： 布爾值。如果所有元素都通過檢測返回 true，否則返回 false。
JavaScript 版本: 1.6

更多實例

實例

檢測數組 ages 的所有元素是否都大於等於輸入框中指定的數字:

<p>最小年齡: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">點我</button>

<p>是否所有年齡都符號條件? <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>

Array 對象參考手冊 JavaScript Array 對象