String.prototype.includes()

¥Syntax

includes(searchString)
includes(searchString, position)

¥Parameters

searchString

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

position Optional

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

¥Return value

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

¥**true** if the search string is found anywhere within the given string, including when searchString is an empty string; otherwise, false.

¥Exceptions

TypeError

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

¥Description

此方法可让你确定一个字符串是否包含另一个字符串。

¥This method lets you determine whether or not a string includes another string.

¥Case-sensitivity

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

¥The includes() method is case sensitive. For example, the following expression returns false:

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

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

¥You can work around this constraint by transforming both the original string and the search string to all lowercase:

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

¥Examples

¥Using includes()

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

¥See also

• core-js 中 String.prototype.includes 的 Polyfill
• Array.prototype.includes()
• TypedArray.prototype.includes()
• String.prototype.indexOf()
• String.prototype.lastIndexOf()
• String.prototype.startsWith()
• String.prototype.endsWith()