JavaScriptのArray.find()について記載します。
概要、実際のサンプルコードを交えて構文などの使い方をまとめてみました。
JavaScriptの配列(Array)とは?
JavaScriptの配列は、異なる要素を格納するために使用される単一の変数です。
要素のリストを格納し、単一の変数でアクセスしたい場合によく使用されています。
配列が複数の変数への参照である他の多くのプログラミング言語とは異なり、JavaScriptでは、配列は複数の要素を格納する単一の変数です。
小難しい説明になりますが、JavaScriptでの配列処理は非常に多くの処理が出来るということです。そして、JavaScriptを使ってコード、システムを作っていくうえで配列処理の基本動作、JSが持っている関数を理解しておくことは非常に重要だと個人に考えています。
開発の現場でも配列処理を正しくそして深く理解していることが求められます。
JSの配列処理はES5,ES6などでアップデートが行われており、本来なら簡潔なコードで記載できるにもかかわらず、冗長なコードで記載してしまったがゆえにバグを発生してしまったり、予期せぬ動作を配列処理が起こしてしまうといったことが起こっていたりもします。
配列処理は頻繁に使用し、そして、もっともバグを生みやすい部分だとも思っているので個人的にJavaScriptで一番重要だと筆者は考えています。
次に本題の説明に移ります。
JavaScriptのArray.find()概要
Array.find()は、配列内の要素を検索し、条件に一致する最初の要素を返します。
Array.find()を使うと、配列内の要素を検索して最初に一致した要素を取得できます。
例えば、配列内のオブジェクトから特定の値を検索したり、特定の条件を満たす要素を取得したりすることができます。
構文、使い方
構文:array.find(callback(element[, index[, array]])[, thisArg])
使い方:Array.find()は、配列内の要素を1つずつ反復処理し、条件を満たす要素を返します。
callback関数には、反復処理中の要素、そのインデックス、反復処理中の配列の3つの引数が渡されます。
thisArgオプションで、callback関数内のthisとして使用する値を指定できます。
引数について
この関数は、要素がテストに合格したかどうかを判断するために、要素を1つずつ引数として受け取ります。
返り値について
Array.find()は、配列内の要素を検索し、条件に合致する最初の要素を返します。
返り値は、条件に合致した最初の要素です。
現場で実際にどのように使われているか
現場では、配列内の要素を検索して、特定の条件に一致する要素を見つけ出すために使用されています。
例えば、データベースから取得した配列内の要素を検索して、特定のIDを持つ要素を見つけ出すことができます。
使用する上での注意点
– find()は配列の中から条件に一致する最初の要素を返すので、条件を満たす要素が複数ある場合は最初の要素のみが返される。
JavaScriptのArray.find()と似た処理のJSメソッド、違い
Array.findIndex()と似ていますが、下記違いがあります。
- Array.find()は、配列内の要素を検索し、最初に一致した要素を返します。
- Array.findIndex()は、配列内の要素を検索し、最初に一致した要素のインデックスを返します。
JavaScriptのArray.find()を使ったサンプルコードの紹介
Array.find()を使ったサンプルコード1
1 2 3 4 5 |
const array1 = [5, 12, 8, 130, 44]; const found = array1.find(element => element > 10); console.log(found); |
Array.find()を使ったサンプルコード2
1 2 3 4 5 6 7 8 9 |
const array2 = [ { name: 'John', age: 20 }, { name: 'Jane', age: 25 }, { name: 'Jim', age: 30 }, ]; const found = array2.find(element => element.name === 'Jane'); console.log(found); |
Array.find()を使ったサンプルコード3
1 2 3 4 5 6 7 8 9 |
const array3 = [ { id: 1, name: 'John' }, { id: 2, name: 'Jane' }, { id: 3, name: 'Jim' }, ]; const found = array3.find(element => element.id === 3); console.log(found); |
JavaScriptの他のArrayメソッドについて
JavaScriptの配列のメソッドについては、下記記事にもまとめていますので参考にしてみてください
メソッド名 | 機能 | リンク |
Array.concat() | 既存の配列に新しい配列または値を連結するための関数 | JavaScriptの配列(Array)のconcatメソッドの使い方 |
Array.constructor
|
配列オブジェクトに定義されているプロパティ | JavaScriptの配列(Array)のconstructorプロパティの使い方 |
Array.copyWithin()
|
配列内の要素を、同じ配列内の別の位置にコピーする関数 | JavaScriptの配列(Array)のcopyWithinメソッドの使い方 |
Array.entries() | 配列内の要素に対応するインデックスと要素のペアを含む新しいイテレータオブジェクトを生成する関数 | JavaScriptの配列(Array)のentriesメソッドの使い方 |
Array.every() | 配列内のすべての要素がテスト関数を満たすかどうかを判定する関数 | JavaScriptの配列(Array)のeveryメソッドの使い方 |
Array.fill() | 配列内の全てまたは一部の要素を指定の値で埋める関数 | JavaScriptの配列(Array)のfillメソッドの使い方 |
Array.filter() | 配列内の要素をテスト関数に基づいてフィルタリングする関数 | JavaScriptの配列(Array)のfilterメソッドの使い方 |
Array.find() | 配列内の要素から最初にテスト関数を満たす要素を検索する関数 | JavaScriptの配列(Array)のfindメソッドの使い方 |
Array.findIndex() | 配列内の要素から最初にテスト関数を満たす要素のインデックスを検索する関数 | JavaScriptの配列(Array)のfindIndexメソッドの使い方 |
Array.forEach() | 配列内のすべての要素に対して処理を実行する関数 | JavaScriptの配列(Array)のforEachメソッドの使い方 |
Array.from() | 配列風オブジェクトや反復可能なオブジェクトから新しい配列を生成する関数 | JavaScriptの配列(Array)のfromメソッドの使い方 |
Array.includes() | 配列内に特定の要素が含まれているかどうかを判定する関数 | JavaScriptの配列(Array)のincludesメソッドの使い方 |
Array.indexOf() | 配列内の指定された要素の最初のインデックスを検索する関数 | JavaScriptの配列(Array)のindexOfメソッドの使い方 |
Array.isArray() | 指定されたオブジェクトが配列であるかどうかを判定する関数 | JavaScriptの配列(Array)のisArrayメソッドの使い方 |
Array.join() | 配列内の要素を文字列に連結する関数 | JavaScriptの配列(Array)のjoinメソッドの使い方 |
Array.keys() | 配列内の要素に対応するインデックスを含む新しいイテレータオブジェクトを生成する関数 | JavaScriptの配列(Array)のkeysメソッドの使い方 |
Array.lastIndexOf()
|
配列内の指定された要素の最後のインデックスを検索する関数 | JavaScriptの配列(Array)のlastIndexOfメソッドの使い方 |
Array.length | 配列内の要素数を表すプロパティ | JavaScriptの配列(Array)のlengthプロパティの使い方 |
Array.map() | 配列内のすべての要素に対して関数を適用し、結果を含む新しい配列を生成する関数 | JavaScriptの配列(Array)のmapメソッドの使い方 |
Array.pop() | 配列内の最後の要素を取り除き、その要素を返す関数 | JavaScriptの配列(Array)のpopメソッドの使い方 |
Array.prototype | 配列オブジェクトのプロトタイプオブジェクト | JavaScriptの配列(Array)のprototypeプロパティの使い方 |
Array.push() | 配列内の最後に要素を追加する関数 | JavaScriptの配列(Array)のpushメソッドの使い方 |
Array.reduce() | 配列内の要素をシンプルな値(通常は数値)に結合する関数 | JavaScriptの配列(Array)のreduceメソッドの使い方 |
Array.reduceRight()
|
配列内の要素を右から左に向かって結合する関数 | JavaScriptの配列(Array)のreduceRightメソッドの使い方 |
Array.reverse() | 配列内の要素の順番を反転する関数 | JavaScriptの配列(Array)のreverseメソッドの使い方 |
Array.shift() | 配列内の最初の要素を取り除き、その要素を返す関数 | JavaScriptの配列(Array)のshiftメソッドの使い方 |
Array.slice() | 配列内の一部を切り出して、新しい配列として返す関数 | JavaScriptの配列(Array)のsliceメソッドの使い方 |
Array.some() | 配列内の要素のいずれかが特定の条件を満たすかどうかをテストする関数 | JavaScriptの配列(Array)のsomeメソッドの使い方 |
Array.sort() | 配列内の要素をソートする関数 | JavaScriptの配列(Array)のsortメソッドの使い方 |
Array.toString() | 配列を文字列に変換する関数 | JavaScriptの配列(Array)のtoStringメソッドの使い方 |
Array.unshift() | 配列内の最初に要素を追加する関数 | JavaScriptの配列(Array)のunshiftメソッドの使い方 |
Array.valueOf() | 配列のプリミティブ値を返却 | JavaScriptの配列(Array)のvalueOfメソッドの使い方 |
また、JavaScriptの公式ドキュメントであるMDNで記載されているfindメソッドについても補足としてリンクを貼っておきます。参考にしてみてください。