JavaScript findIndex()メソッド
例
配列内で年齢が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) | 必須。配列の各要素に対して実行する関数です。 関数の引数:
|
||||||||
| 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);
}
試してみる »
その他の拡張
JavaScript Array オブジェクト