String.includes() 是否包含子串
最后更新：2026-09-09
String.includes() 是否包含子串
includes 判断字符串是否包含指定子串，返回 true 或 false，可传起始位置。判断关键词存在性的首选方法。
| 分类 | 字符串 |
|---|---|
| ES 版本 | ES2015 |
📝 语法
const 是否包含 = 字符串.includes(子串, 起始位置);⚙️ 参数
| substring | 要搜索的子串，区分大小写。 |
|---|---|
| position | 可选。开始搜索的位置，默认 0。 |
返回值：布尔值。
是否修改原值：否（返回新值）
▶ 示例
编辑下方代码，点击运行，在输出面板查看结果：
运行结果：
true
false
true💡 提示 搜索前先 toLowerCase() 是忽略大小写的标准写法。
ℹ️ info includes 对空子串永远返回 true。
🌐 浏览器支持
| 浏览器 |  Chrome |
 Edge |
 Firefox |
 Safari |
 Opera |
|---|---|---|---|---|---|
| String.includes() | ✓ v41 | ✓ v12 | ✓ v40 | ✓ v9 | ✓ v28 |
| 所有现代浏览器均支持 | |||||
🏷️ 相关条目
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Qincludes 和 indexOf 怎么选？
A只需判断有没有用 includes（返回布尔）；还需要位置信息用 indexOf。
Qincludes 区分大小写吗？
A区分。忽略大小写：str.toLowerCase().includes(keyword.toLowerCase())。
Qincludes 能用正则吗？
A不能。需要正则用 str.match(/pattern/) 或 /pattern/.test(str)。
