JavaScript Array includes()

Array.includes() 方法用于判断一个数组是否包含一个指定的值，返回值为布尔类型。这个方法可以用在字符串、数字、布尔类型等数据类型的数组中。

语法

arr.includes(searchElement[, fromIndex])

参数

• searchElement: 要查找的元素值
• fromIndex（可选）：从此位置开始查找。如果省略此参数，则从数组开头开始搜素。如果 fromIndex 大于或等于数组的长度，则返回 false，因为查找不到目标。

返回值

• true：如果指定的元素存在于数组中。
• false：如果指定的元素不存在于数组中。

实例

const arr = [1, 2, 3];

console.log(arr.includes(2)); // true
console.log(arr.includes(4)); // false

const greetings = ['Hello', 'Bonjour', 'Hola', 'こんにちは', '안녕하세요'];

console.log(greetings.includes('안녕하세요')); // true
console.log(greetings.includes('Ciao')); // false

兼容性

这个方法在 ECMAScript 2016 标准中被引入，因此不是所有浏览器都支持它。在 IE 和 Edge 中，这个方法的支持程度不完整。在使用时，需要先进行兼容性检查或者向下兼容。

参考资料

• MDN Web 文档