【Node.js24.x】Array::includes()メソッドの使い方

includesメソッドは、JavaScriptのArrayオブジェクトが持つ組み込みのメソッドであり、特定の要素が配列内に存在するかどうかを判定するメソッドです。このメソッドは、指定された要素が配列内に見つかった場合はtrue（真）を返し、見つからなかった場合はfalse（偽）を返します。

このメソッドは、searchElementとfromIndexという2つの引数を取ります。searchElementは配列内で検索したい値を指定します。fromIndexはオプションの引数で、配列のどのインデックスから検索を開始するかを指定します。この引数が省略された場合、検索は配列の先頭（インデックス0）から開始されます。fromIndexに負の値が指定された場合は、配列の末尾からのオフセットとして扱われ、array.length + fromIndexで計算されるインデックスから検索が実行されます。たとえば、配列の長さが5でfromIndexが-3の場合、検索はインデックス2から開始されます。

includesメソッドは、要素の比較に厳密等価比較（===）を使用します。これは、値だけでなく型も一致する必要があることを意味します。また、NaN（Not-a-Number）という特殊な値についても、includesメソッドは他の検索メソッドとは異なり、正しく検出できる特性を持っています。このメソッドは、配列の内容を効率的に確認し、プログラムのロジックにおいて条件分岐など様々な場面で利用できるため、プログラミングにおいて非常に役立ちます。

Copy
1const myArray = [10, 20, 30];
2const hasValue = myArray.includes(20);

searchElement, fromIndex = 0

• searchElement: number: 検索する要素
• fromIndex: number = 0: 検索を開始するインデックス

boolean

配列に指定した要素が含まれているかどうかを判定し、含まれていればtrue、含まれていなければfalseを返します。