JavaScript字符串包含判断方法详解:includes、indexOf等用法与实战
本文讲解JavaScript中一项基础且高频使用的技术问题:如何判断一个字符串包含指定字符或子字符串。将逐一拆解各类判断方法,清晰说明用法、特性与适用场景。
方法一览
JavaScript中,字符串包含关系检查主要通过以下方法实现,各项核心属性对比如下:
方法名 | 作用 | 返回类型 | 是否区分大小写 | 备注 |
|---|---|---|---|---|
includes() | 检查字符串是否包含指定子串 | 布尔值(true/false) | 区分 | 最常用、语义直观,适合基础判断场景 |
indexOf() | 查找子串首次出现的位置 | 数字(索引值或-1) | 区分 | 经典老牌方法,功能拓展性更强 |
search() | 通过正则表达式查找匹配项 | 数字(索引值或-1) | 取决于正则配置 | 适合复杂模式匹配场景 |
match() | 通过正则表达式查找并提取匹配内容 | 数组或null | 取决于正则配置 | 功能全面,支持匹配内容提取 |
test()(正则方法) | 测试正则与字符串是否匹配 | 布尔值(true/false) | 取决于正则配置 | 专属正则对象的匹配判断方法 |
下文对各类方法逐一详细说明。
1. includes() 方法:简洁直接的基础判断
该方法为当前字符串包含判断的首选方案,核心用途为单纯判断指定子串是否存在,返回布尔值结果。
基本用法
let str = "Hello, world!";
let result = str.includes("world");
console.log(result); // 输出:true用法逻辑清晰,若目标字符串包含指定子串,返回true,反之返回false。
大小写区分特性
let str = "Hello, world!";
console.log(str.includes("World")); // 输出:false该方法默认区分大小写,原字符串为小写w开头的world,匹配大写W开头的World无匹配结果,返回false。
指定起始搜索位置
includes()支持传入第二个参数,用于定义字符串检索的起始索引位置。
let str = "JavaScript is fun!";
console.log(str.includes("is", 5)); // 从索引5开始检索,输出:true
console.log(str.includes("is", 12)); // 从索引12开始检索,输出:false优缺点说明
2. indexOf() 方法:经典通用的检索方案
在includes()方法推出前,indexOf()是字符串包含判断的主流方案,属于底层经典方法,功能适用性更广。
基本用法
let str = "Hello, world!";
let position = str.indexOf("world");
console.log(position); // 输出:7indexOf()返回子串首次出现的索引位置,字符串索引从0开始计数,world在目标字符串中从索引7开始。
核心判定规则:未检索到子串时,返回-1;通过判断返回值是否不等于-1,即可确认是否包含指定子串。
let str = "Hello, world!";
if (str.indexOf("world") !== -1) {
console.log("找到了!");
} else {
console.log("没找到。");
}
// 输出:找到了!附加特性
该方法同样区分大小写,且支持指定检索起始位置,用法与includes()一致。
let str = "abcABCabc";
console.log(str.indexOf("ABC")); // 输出:3
console.log(str.indexOf("abc")); // 输出:0
console.log(str.indexOf("xyz")); // 输出:-1(未匹配到)
console.log(str.indexOf("abc", 2)); // 从索引2开始检索,输出:6indexOf() 与 includes() 对比
仅需判断是否包含子串,优先选用includes(),代码更简洁,直接通过if (str.includes('x'))实现判断;
需获取子串出现的具体位置,选用indexOf(),该方法可返回对应索引值;
性能层面,两种方法差异极小,选择依据以业务需求和编码习惯为准。
3. search() 方法:适配正则的灵活检索
当需要灵活匹配规则,如忽略大小写、匹配特定模式(数字、空格等)时,search()方法更为适用。
基本用法
search()接收正则表达式作为参数,返回首个匹配项的索引位置,未匹配到则返回-1,返回值规则与indexOf()一致。
let str = "Hello, WORLD!";
// 正则表达式 /world/i,i为忽略大小写标识
let position = str.search(/world/i);
console.log(position); // 输出:7通过正则i标识,可实现不区分大小写的匹配,即便原字符串为大写WORLD,也可正常匹配。
该方法仅返回首个匹配项的位置,无法获取后续匹配结果。
let str = "apples and apples";
console.log(str.search(/apples/)); // 输出:0注意:若传入字符串参数,search()会将其隐式转换为正则表达式,易引发意外匹配,建议直接传入规范正则表达式。
// 不推荐用法:字符串隐式转正则,匹配任意单个字符
console.log("hello".search(".")); // 输出:0
// 推荐用法:明确编写正则,匹配实际点号
console.log("hello".search(/\./)); // 输出:-14. match() 方法:支持内容提取的正则匹配
match()功能比search()更全面,除定位匹配位置外,还可提取匹配到的具体内容。
基本用法
let str = "The year is 2023 and next is 2024.";
let result = str.match(/\d+/); // 正则 \d+ 匹配单个或连续数字
console.log(result);
// 输出数组:[ '2023', index: 12, input: 'The year is 2023 and next is 2024.', groups: undefined ]返回数组首元素为匹配到的字符串,同时附带index属性标注匹配位置,未匹配到则返回null。
全局匹配用法
正则添加g(全局匹配)标识后,match()会返回所有匹配项组成的数组,不再附带index等属性。
let str = "2023 and 2024";
let result = str.match(/\d+/g);
console.log(result); // 输出: [ '2023', '2024' ]包含判断用法
通过判断返回值是否为null,即可确认是否包含匹配内容。
let str = "Hello world";
if (str.match(/world/)) {
console.log("包含!");
}5. 正则test() 方法
test()不属于字符串原生方法,而是正则对象专属方法,属于高频使用的匹配判断方案,需重点说明。
基本用法
先创建正则对象,再通过test()方法检测目标字符串是否匹配,直接返回布尔值。
let str = "Hello, world!";
let regex = /world/;
let result = regex.test(str);
console.log(result); // 输出:truetest()返回布尔值,适配条件判断场景,无需提取匹配内容,执行效率通常高于match()。
复杂匹配示例
// 检查字符串是否同时包含至少一个数字和一个大写字母
let password = "Pass123";
let hasNumber = /\d/.test(password);
let hasUpper = /[A-Z]/.test(password);
if (hasNumber && hasUpper) {
console.log("密码强度不错!");
}常见问题与注意事项
大小写区分问题:includes()、indexOf()默认区分大小写,需忽略大小写时,可将字符串统一转为小写(toLowerCase()),或选用正则类方法实现。 // 统一转小写后匹配,实现忽略大小写 let str = "JavaScript"; console.log(str.toLowerCase().includes("script")); // true
正则特殊字符处理:使用search()、match()、test()时,参数为正则表达式,若子串包含.、*、?等正则特殊字符,需进行转义处理,避免匹配异常。 let filename = "test.js"; // 错误用法:. 匹配任意字符,导致匹配错误 console.log(filename.search(".js")); // 输出:0 // 正确用法:对特殊字符转义 console.log(filename.search(/\.js/)); // 输出:4
indexOf()判断逻辑:经典判断逻辑为校验返回值是否不等于-1,易误写为===-1导致逻辑反转,选用includes()可规避该问题。
性能考量:超长字符串、高频操作场景下,indexOf()底层执行效率略优,但绝大多数业务场景下,性能差异可忽略,优先保证代码可读性与可维护性。
本文内容仅供个人学习、研究或参考使用,不构成任何形式的决策建议、专业指导或法律依据。未经授权,禁止任何单位或个人以商业售卖、虚假宣传、侵权传播等非学习研究目的使用本文内容。如需分享或转载,请保留原文来源信息,不得篡改、删减内容或侵犯相关权益。感谢您的理解与支持!