JavaScript String includes() 方法

定义和用法

如果字符串包含指定的字符串，includes() 方法将返回 true。

否则返回 false。

includes() 方法区分大小写。

实例

例子 1

检查字符串是否包含 "world"：

let text = "Hello world, welcome to the universe.";
let result = text.includes("world");

亲自试一试

let text = "Hello World, welcome to the universe.";
let result = text.includes("world", 12);

亲自试一试

例子 2

从位置 12 开始：

let text = "Hello world, welcome to the universe.";
let result = text.includes("world", 12);

亲自试一试

语法

string.includes(searchvalue, start)

参数

参数 描述
searchvalue 必需。要搜索的字符串。
start 可选。开始的位置。默认值为 0。

返回值

类型 描述
布尔值 如果字符串包含该值，则为 true，否则为 false。

浏览器支持

includes() 是 ECMAScript6 (ES6) 特性。

所有现代浏览器都支持 ES6 (JavaScript 2015)：

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
支持 支持 支持 支持 支持

Internet Explorer 11（或更早版本）不支持 includes()。

相关页面

JavaScript 字符串

JavaScript 字符串方法

JavaScript 字符串搜索