String.prototype.includes()

该includes() 方法的String值执行大小写敏感的搜索，以确定给定的字符串是否可能在该字符串内找到，并根据情况返回true或false。

试试

语法

js
includes(searchString)
includes(searchString, position)

参数

searchString

要在str中搜索的字符串。不能是正则表达式。所有非正则表达式的值都将强制转换为字符串，因此省略它或传递undefined会导致includes()搜索字符串"undefined"，这很少是您想要的。

position 可选

字符串中开始搜索searchString的位置。（默认为0。）

返回值

如果在给定字符串内的任何位置找到搜索字符串，包括当searchString为空字符串时，则为true；否则为false。

异常

类型错误

如果searchString是正则表达式，则抛出。

描述

此方法允许您确定字符串是否包含另一个字符串。

区分大小写

includes()方法区分大小写。例如，以下表达式返回false

js
"Blue Whale".includes("blue"); // returns false

您可以通过将原始字符串和搜索字符串都转换为小写来解决此约束

js
"Blue Whale".toLowerCase().includes("blue"); // returns true

示例

使用 includes()

js
const str = "To be, or not to be, that is the question.";

console.log(str.includes("To be")); // true
console.log(str.includes("question")); // true
console.log(str.includes("nonexistent")); // false
console.log(str.includes("To be", 1)); // false
console.log(str.includes("TO BE")); // false
console.log(str.includes("")); // true

规范

规范
ECMAScript 语言规范
# sec-string.prototype.includes

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参见