string.prototype.includes()用于判断字符串是否包含指定子串，返回布尔值；区分大小写，可选起始位置参数；仅适用于字符串，数字需转字符串，数组应使用array.prototype.includes()；兼容现代环境，旧版可用indexof替代。

String.prototype.includes() 是 JavaScript 中判断字符串是否包含指定子串的简洁方法，返回布尔值 true 或 false。

基本用法：检查是否包含子串

语法：str.includes(searchString[, position])

• searchString：要查找的子串（会自动转为字符串）
• position（可选）：开始搜索的位置，默认为 0（从开头查）

示例：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

const text = "Hello, world!";
console.log(text.includes("world")); // true
console.log(text.includes("World")); // false（区分大小写）
console.log(text.includes("o", 5)); // true（从索引 5 开始找 "o"）

注意大小写敏感

该方法默认区分大小写。如需忽略大小写，可先统一转换：

const text = "JavaScript is great";
console.log(text.toLowerCase().includes("javascript")); // true
// 或用正则 + test() 实现更灵活的忽略大小写匹配

不能直接用于数组或数字

includes 是字符串方法，只适用于字符串类型：

• 对数字：需先转字符串，如 (123).toString().includes("2")
• 对数组：应使用 Array.prototype.includes()，不是同一个方法
• 对 null/undefined 调用会报错，建议先做类型检查

const num = 456;
console.log(num.toString().includes("5")); // true

const arr = ["a", "b", "c"];
console.log(arr.includes("b")); // true（这是数组的 includes）

兼容性与替代方案

支持现代浏览器和 Node.js 4+。若需兼容旧环境（如 IE），可用 indexOf 替代：

const str = "hello";
// 等价写法
console.log(str.indexOf("ll") !== -1); // true

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南