JavaScript findIndex()メソッド

Array 对象参考手册JavaScript Array オブジェクト

例

配列内で年齢が18以上の最初の要素のインデックス位置を取得する

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

fruits出力結果:

2

試してみる »

定義と用法

findIndex() メソッドは、テスト条件(関数)を渡し、条件を満たす配列の最初の要素の位置を返します。

findIndex() メソッドは、配列の各要素に対して関数を1回実行します:

  • 配列内の要素がテスト条件で返す場合true、findIndex() は条件に一致する要素のインデックス位置を返し、以降の値に対して関数を呼び出しません。
  • 条件に一致する要素がない場合は -1 を返します。

注意:findIndex() は空の配列に対しては、関数を実行しません。

注意:findIndex() は配列の元の値を変更しません。


ブラウザサポート

表内の数字は、そのメソッドをサポートする最初のブラウザバージョン番号を示します。

メソッド
findIndex() 45.0 12.0 25.0 7.1 32.0

注意:IE 11 およびそれ以前のバージョンは findIndex() メソッドをサポートしていません。


構文

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

引数

引数 説明
function(currentValue, index,arr) 必須。配列の各要素に対して実行する関数です。
関数の引数:
引数 説明
currentValue 必須。現在の要素
index 省略可能。現在の要素のインデックス
arr 省略可能。現在の要素が属する配列オブジェクト
thisValue 省略可能。関数に渡す値で、通常は "this" 値を使用します。
この引数が空の場合、"undefined" が "this" 値に渡されます。

技術的な詳細

戻り値: テスト条件に一致する最初の配列要素のインデックスを返します。条件に一致するものがない場合は -1 を返します。
JavaScript バージョン: ECMAScript 6

その他の例

例

入力ボックスの数値より大きい配列インデックスを返します:

var ages = [4, 12, 16, 20]; function checkAdult(age) { return age >= document.getElementById("ageToCheck").value; } function myFunction() { document.getElementById("demo").innerHTML = ages.findIndex(checkAdult); }

試してみる »

Array 对象参考手册JavaScript Array オブジェクト

その他の拡張