JavaScript Array includes() メソッド
例
配列の検出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
JavaScript Array オブジェクト