JavaScript Array includes() メソッド

Array 对象参考手册JavaScript Array オブジェクト

例

配列の検出siteサンプル を含むか:

let site = ['サンプル', 'google', 'taobao']; site.includes('サンプル'); // true site.includes('baidu'); // false

試してみる »

定義と用法

includes() メソッドは、配列が指定された値を含むかどうかを判断するために使用されます。含む場合は true を返し、それ以外の場合は false を返します。

[1, 2, 3].includes(2);     // true
[1, 2, 3].includes(4);     // false
[1, 2, 3].includes(3, 3);  // false
[1, 2, 3].includes(3, -1); // true
[1, 2, NaN].includes(NaN); // true

ブラウザサポート

表内の数字は、そのメソッドをサポートする最初のブラウザのバージョン番号を示します。

メソッド
includes() 47 14 43 9 34

構文

arr.includes(searchElement)
arr.includes(searchElement, fromIndex)

パラメータの説明

パラメータ 説明
searchElement 必須。検索する要素の値。
fromIndex 省略可能。このインデックスから searchElement の検索を開始します。負の値の場合、array.length + fromIndex のインデックスから昇順で検索を開始します。デフォルトは 0 です。

技術的な詳細

戻り値: ブール値。指定された値が見つかった場合は true を返し、それ以外の場合は false を返します。
JavaScript バージョン: ECMAScript 6

その他の例

fromIndex が配列の長さ以上の場合

fromIndex が配列の長さ以上の場合、false を返します。この配列は検索されません:

例

var arr = ['a', 'b', 'c']; arr.includes('c', 3); //false arr.includes('c', 100); // false

計算されたインデックスが 0 未満の場合

fromIndex が負の値の場合、計算されたインデックスが searchElement の検索開始位置となります。計算されたインデックスが 0 未満の場合、配列全体が検索されます。

例

//配列の長さは 3 //fromIndex は -100 //computed index は 3 + (-100) = -97 var arr = ['a', 'b', 'c']; arr.includes('a', -100); // true arr.includes('b', -100); // true arr.includes('c', -100); // true

Array 对象参考手册JavaScript Array オブジェクト

その他の拡張