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>最低年齢: <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>

実際に試してみてください

例 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 配列のイテレーション