JavaScript Array includes() 方法 | JavaScript Array 对象

返回到:JavaScript对象:JavaScript Array 对象

定义和用法

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() 方法。

语法

arr.includes(searchElement)
arr.includes(searchElement, fromIndex)

参数说明

参数描述
searchElement必须。需要查找的元素值。
fromIndex可选。从该索引处开始查找 searchElement。如果为负值,则按升序从 array.length + fromIndex 的索引开始搜索。默认为 0。

技术细节

返回值:布尔值。如果找到指定值返回 true,否则返回 false。
JavaScript 版本:ECMAScript 6

实例

检测数组 site 是否包含 Web176:

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Web176教程(Web176.com)</title>
</head>
<body>

<script>
let site = ['Web176', 'google', 'taobao'];

document.write(site.includes('Web176')); 
// true 

document.write("<br>"); 
	
document.write(site.includes('baidu')); 
// false
</script>

</body>
</html>

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

作者:terry,如若转载,请注明出处:https://www.web176.com/javascriptbook/jsarrtips/3433.html

(0)
打赏 支付宝 支付宝 微信 微信
terryterry
上一篇 2021年9月6日 下午3:55
下一篇 2021年9月6日 下午4:09

相关推荐

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注