String.prototype.includes()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

String 值的 includes() 方法执行区分大小写的搜索,以确定是否可以在一个字符串中找到另一个字符串,并根据情况返回 truefalse

尝试一下

语法

js
includes(searchString)
includes(searchString, position)

参数

searchString

一个要在 str 中查找的字符串。不能是正则表达式。所有非正则表达式的值都会被强制转换为字符串,因此如果该参数被省略或传入 undefinedincludes() 方法会在字符串中搜索 "undefined",这通常不是你想要的。

position 可选

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

返回值

如果在给定的字符串中找到了要搜索的字符串(包括 searchString 为空字符串的情况),则返回 true,否则返回 false

异常

TypeError

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

描述

此方法可以帮你判断一个字符串是否包含另外一个字符串。

区分大小写

includes() 方法是区分大小写的。例如,下面的表达式会返回 false

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

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

js
"Blue Whale".toLowerCase().includes("blue"); // 返回 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

规范

Specification
ECMAScript Language Specification
# sec-string.prototype.includes

浏览器兼容性

BCD tables only load in the browser

参见