JavaScript includes() 方法详解:字符串与数组的用法

作者:函数茶馆

时间:2026-10-30

浏览:395

本文详细介绍 JavaScript 中 includes() 方法的用法。该方法用于判断字符串或数组是否包含指定值,返回布尔结果。涵盖字符串与数组两种场景下的语法、参数说明(如 fromIndex)及边界情况处理。注意该方法区分大小写,且仅支持 ECMAScript 6 及以上版本,IE 浏览器不支持。

文章目录

字符串 includes

用于检测目标字符串中是否存在指定的子字符串。

示例:检测字符串中是否包含 "Jb51"。

定义和用法

includes() 方法的作用是判断当前字符串是否包含指定的子字符串。

若找到匹配的子字符串,则返回 true;否则返回 false。

注意:includes() 方法在执行匹配时区分大小写。

语法

string.includes(searchvalue, start)

参数值

参数描述
searchvalue必需,要查找的字符串。
start可选,设置从那个位置开始查找,默认为 0。

返回值

类型描述
Boolean如果找到匹配的字符串返回 true,否则返回 false。

技术细节

JavaScript 版本:ECMAScript 6
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>本站(jb51.net)</title>
</head>
<body>
<p>点击按钮查看检测结果。</p>
<button onclick="myFunction()">点我</button>
<p id="demo"></p>
<p><strong>注意:</strong> IE 11 及更早版本不支持 includes() 方法 。</p>
<script>
function myFunction() {
  var str = "Hello world, welcome to the Jb51.";
  var n = str.includes("Jb51");
  document.getElementById("demo").innerHTML = n;
}
</script>
</body>
</html>

数组 includes

JavaScript Array includes() 方法

定义和用法

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

语法

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 为负值,系统会计算出一个起始搜索索引。如果计算出的索引小于 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
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>本站(jb51.net)</title>
</head>
<body>
<script>
let site = ['Jb51', 'google', 'taobao'];
document.write(site.includes('Jb51')); 
// true 
document.write("<br>"); 	
document.write(site.includes('baidu')); 
// false
</script>
</body>
</html>

到此这篇关于JavaScript中字符串与数组的includes()用法的文章就介绍到这了,更多相关字符串与数组的includes内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站!

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章