JavaScriptのArray.includes()について記載します。
概要、実際のサンプルコードを交えて構文などの使い方をまとめてみました。
JavaScriptの配列(Array)とは?
JavaScriptの配列は、異なる要素を格納するために使用される単一の変数です。
要素のリストを格納し、単一の変数でアクセスしたい場合によく使用されています。
配列が複数の変数への参照である他の多くのプログラミング言語とは異なり、JavaScriptでは、配列は複数の要素を格納する単一の変数です。
小難しい説明になりますが、JavaScriptでの配列処理は非常に多くの処理が出来るということです。そして、JavaScriptを使ってコード、システムを作っていくうえで配列処理の基本動作、JSが持っている関数を理解しておくことは非常に重要だと個人に考えています。
開発の現場でも配列処理を正しくそして深く理解していることが求められます。
JSの配列処理はES5,ES6などでアップデートが行われており、本来なら簡潔なコードで記載できるにもかかわらず、冗長なコードで記載してしまったがゆえにバグを発生してしまったり、予期せぬ動作を配列処理が起こしてしまうといったことが起こっていたりもします。
配列処理は頻繁に使用し、そして、もっともバグを生みやすい部分だとも思っているので個人的にJavaScriptで一番重要だと筆者は考えています。
次に本題の説明に移ります。
JavaScriptのArray.includes()概要
Array.includes()は、配列内に特定の値が含まれているかどうかを判定するメソッドです。
構文、使い方
構文: array.includes(value)
使い方: Array.includes()は、指定した値が配列内に存在するかどうかを判定します。
引数に指定した値が配列内に存在する場合はtrueを、存在しない場合はfalseを返します。
引数について
Array.includes()の引数は、検索する値を指定します。
返り値について
Array.includes()は、配列内に指定した値が存在するかどうかを判定するメソッドです。
返り値は、指定した値が存在する場合はtrue、存在しない場合はfalseです。
このメソッドを利用した便利なテクニック
Array.includes()を使うと、配列内に特定の値が含まれているかどうかを簡単に確認できます。
例えば、次のようなコードを使うと、配列内に特定の値が存在するかどうかを確認できます。
1 2 3 4 5 6 7 |
let array = [1,2,3,4,5]; if (array.includes(3)) { console.log('3が含まれています'); } else { console.log('3は含まれていません'); } |
現場で実際にどのように使われているか
Array.includes()は、配列内に特定の値が含まれているかどうかを判定するために使用されます。
例えば、配列内に特定の文字列が含まれているかどうかを判定する場合、以下のように使用します。
1 2 |
const array = [""apple"", ""banana"", ""orange""]; array.includes(""apple""); // true |
JavaScriptのArray.includes()と一緒によく使われる処理
Array.find()を使用して、Array.includes()の結果がtrueの場合に、その要素を取得することが多いです。
なぜなら、Array.includes()は指定した要素が配列に含まれているかどうかを判定するだけなので、trueの場合はその要素を取得する必要があるからです。
使用する上での注意点
– includes()は、配列内の要素が指定した値と等しいかどうかを判定するために使用します。
– 引数として渡された値が、配列内の要素のデータ型と一致している必要があります。
– includes()は、配列内の要素をインデックス順に検索します。
JavaScriptのArray.includes()と似た処理のJSメソッド、違い
Array.indexOf()と似ていますが、下記違いがあります。
- Array.includes()は、指定した値が配列内に存在するかどうかを判定します。
- Array.indexOf()は、指定した値が配列内で最初に見つかったインデックスを返します。
JavaScriptのArray.includes()を使ったサンプルコードの紹介
Array.includes()を使ったサンプルコード
1 2 3 4 5 6 7 8 |
// 配列を定義 const array = [1, 2, 3, 4, 5]; // 配列に3が含まれているかを確認 const result = array.includes(3); // 結果を表示 console.log(result); |
1 2 3 4 5 6 7 8 |
// 配列を定義 const array = [1, 2, 3, 4, 5]; // 配列に6が含まれているかを確認 const result = array.includes(6); // 結果を表示 console.log(result); |
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で記載されているincludesメソッドについても補足としてリンクを貼っておきます。参考にしてみてください。