JavaScript Array includes() 方法

定義和用法

includes() 方法確定數組是否包含指定的元素。

如果數組包含元素，則此方法返回 true，否則返回 false。

注釋：includes() 方法區分大小寫。

實例

例子 1

檢查數組是否包含 "Mango"：

var fruits = ["Banana", "Orange", "Apple", "Mango"];
var n = fruits.includes("Mango");

親自試一試

例子 2

檢查數組是否包含 "Banana"，從位置 3 開始搜索：

var fruits = ["Banana", "Orange", "Apple", "Mango"];
var n = fruits.includes("Banana", 3);

親自試一試

語法

array.includes(element, start)

參數值

參數 描述
element 必需。要搜索的元素。
start 可選。默認 0。在數組中的哪個位置開始搜索。

技術細節

返回值： 布爾值
JavaScript 版本： ECMAScript 7

瀏覽器支持

表格中的數字注明了完全支持該方法的首個瀏覽器版本。

Chrome Edge Firefox Safari Opera
Chrome 47 Edge 14 Firefox 43 Safari 9 Opera 34
2015 年 12 月 2015 年 12 月 2015 年 12 月 2015 年 9 月 2015 年 12 月

注釋：Edge 13（及更早版本）不支持 includes() 方法。

相關頁面

教程：JavaScript 數組

教程：JavaScript 數組 Const

教程：JavaScript 數組方法

教程：JavaScript 排序數組

教程：JavaScript 數組迭代