JavaScript find()メソッド
例
配列内で年齢が18より大きい最初の要素を取得する
var ages = [3, 10, 18, 20];
function checkAdult(age) {
return age >= 18;
}
function myFunction() {
document.getElementById("demo").innerHTML = ages.find(checkAdult);
}
fruits出力結果:
18
試してみる »
定義と使い方
find() メソッドは、テスト(関数内の判定)を通過した配列の最初の要素の値を返します。
find() メソッドは、配列の各要素に対して関数を1回ずつ呼び出して実行します:
- 配列の要素がテスト条件を満たすときに返すtrueと、find() は条件に一致する要素を返し、それ以降の値については関数を呼び出しません。
- 条件に一致する要素がない場合は undefined を返します。
注意:find() は空の配列に対しては、関数は実行されません。
注意:find() は配列の元の値を変更しません。
ブラウザサポート
表内の数字は、そのメソッドをサポートする最初のブラウザバージョン番号を示します。
| メソッド | |||||
|---|---|---|---|---|---|
| find() | 45.0 | 12.0 | 25.0 | 7.1 | 32.0 |
注意:IE 11 およびそれ以前のバージョンは find() メソッドをサポートしていません。
構文
array.find(function(currentValue, index, arr),thisValue)
引数
| 引数 | 説明 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| function(currentValue, index,arr) | 必須。配列の各要素に対して実行する関数です。 関数の引数:
|
||||||||
| thisValue | 省略可能。関数に渡す値で、通常は "this" 値として使用されます。 この引数が空の場合、"undefined" が "this" 値として渡されます。 |
技術詳細
| 戻り値: | テスト条件に一致する最初の配列要素の値を返します。条件に一致する要素がない場合は返します。undefined。 |
|---|---|
| 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.find(checkAdult);
}
試してみる »
その他の拡張
JavaScript Array オブジェクト