JavaScript Array includes() 方法

Array 對象參考手冊 JavaScript Array 對象

實例

檢測數組 site 是否包含 zaixian :

let site = ['zaixian', 'google', 'taobao']; site.includes('zaixian'); // 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 對象