JavaScript Array some() メソッド

定義と使用法

some() このメソッドは配列の要素がテスト（関数として提供された）を通過するかどうかをチェックします。

some() このメソッドは配列の各要素に対して一度だけ関数を実行します：

  • 関数が真値の配列要素を返す場合、some()は真を返します（残りの値をチェックしません）
  • それ以外の場合は false を返します。

注記：some() 値のない配列の要素には関数を実行しません。

注記：some() 元の配列を変更しません。

実例

例 1

ages配列に18以上の値があるかどうかを確認します：

var ages = [3, 10, 18, 20];
function checkAdult(age) {
  return age >= 18;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.some(checkAdult);
}

自分で試してみる

例 2

ages配列のいかなる値も特定の数字に等しいかまたはそれ以上かを確認します：

<p>最低年齢: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">試してみる</button>
<p>18歳以上のすべての年齢： <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.some(function(currentValue, index, arr), thisValue)

パラメータ値

パラメータ 説明
function(currentValue, index, arr) 必須。配列の各要素に実行される関数。

関数パラメータ：

パラメータ 説明
currentValue 必須。現在の要素の値。
index オプション。現在の要素の配列インデックス。
arr オプション。現在の要素が属する配列オブジェクト。
thisValue

オプション。関数に渡してその「this」値として使用する値。

このパラメータが空の場合、値「undefined」がその「this」値として渡されます。

技術的詳細

返り値： ブール値。配列のいかなる要素もテストを通過した場合、true を返し、それ以外の場合は false を返します。
JavaScript バージョン： ECMAScript 3

ブラウザのサポート

テーブルの数字には、このメソッドを完全にサポートする最初のブラウザのバージョンが記載されています。

すべてのブラウザが完全にサポートしています some() 方法：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
サポート 9.0 サポート サポート サポート サポート

関連ページ

チュートリアル：JavaScript 配列

チュートリアル：JavaScript 配列 Const

チュートリアル：JavaScript 配列メソッド

チュートリアル：JavaScript 配列のソート

チュートリアル：JavaScript 配列のイテレーション