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() メソッドは配列の各要素を順番に実行します:

  • 1つの要素が条件を満たす場合、式は true を返し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 オブジェクト

その他の拡張