Array.prototype.includes
方法返回一个布尔值,表示某个数组是否包含给定的值,与字符串的includes
方法类似。ES2016引入了该方法。
includes()
方法用来判断一个数组是否包含一个指定的值,如果是返回 true
,否则false
。
includes()
方法在字符串中使用时,相当于indexOf()
,查询成功返回true
,失败返回false
。
'abc'.includes('ab') // true
'abc'.includes('d') // false
在数组中使用时,可以查询某个元素是否包含在数组中(只能查询Number,String类型的元素)
[1 , 2, 3].includes(0) // false
['1' , '2', '3'].includes('1') // true
[1, 2, 3].includes(2) // true
[1, 2, 3].includes(4) // false
[1, 2, NaN].includes(NaN) // true
该方法的第二个参数表示搜索的起始位置,默认为0。如果第二个参数为负数,则表示倒数的位置,如果这时它大于数组长度(比如第二个参数为-4, 但数组长度为3),则会重置为0开始。
[1, 2, 3].includes(3, 3); // false
[1, 2, 3].includes(3, -1); // true
没有该方法之前,我们通常使用数组的indexOf
方法,检查是否包含某个值。
if (arr.indexOf(el) !== -1) {
// ...
}
indexOf
方法有两个缺点,一是不够语义化,它的含义是找到参数值的第一个出现位置,所以要去比较是否不等于-1,表达起来不够直观。二是,它内部使用严格相等(Strict Equality Comparison
)运算符进行判断,这会导致对NaN的误判。includes
使用的是不一样的判断算法(SameValueZero
策略),就没有这个问题。
[NaN].indexOf(NaN) // -1
[NaN].includes(NaN) // true
下面代码用来检查当前环境是否支持该方法,如果不支持,部署一个简易的替代版本。
const contains = (() => Array.prototype.includes
? (arr, value) => arr.includes(value)
:(arr, value) => arr.some(el => el === value)
)()
另外,Map
和Set
数据结构有一个has
方法需要注意与includes
区分。
Map
结构的has
方法,是用来查找键名的,比如Map.prototype.has(key)
,WeakMap.prototype.has(key)
,Reflect.has(target, propertyKey)
Set
结构的has
方法,是用来查找值的,比如Set.prototype.has(value)
,WeakSet.prototype.has(value)
本文固定连接:https://code.zuifengyun.com/2020/03/2154.html,转载须征得作者授权。