JavaScript Array some() 方法

Array 對象參考手冊 JavaScript Array 對象

實例

檢測數組中是否有元素大於 18:

var ages = [3, 10, 18, 20];

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

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

輸出結果為:

true


定義和用法

some() 方法用於檢測數組中的元素是否滿足指定條件(函數提供)。

some() 方法會依次執行數組的每個元素:

  • 如果有一個元素滿足條件,則運算式返回true , 剩餘的元素不會再執行檢測。
  • 如果沒有滿足條件的元素,則返回false。

注意: some() 不會對空數組進行檢測。

注意: some() 不會改變原始數組。


流覽器支持

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

方法
some() Yes 9 1.5 Yes Yes

語法

array.some(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 = [4, 12, 16, 20];

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

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

Array 對象參考手冊 JavaScript Array 對象