此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。
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 2015年9月.
String 值的includes() 方法执行区分大小写的搜索，以确定是否可以在一个字符串中找到另一个字符串，并根据情况返回true 或false。
尝试一下
const sentence = "The quick brown fox jumps over the lazy dog.";const word = "fox";console.log( `The word "${word}" ${ sentence.includes(word) ? "is" : "is not" } in the sentence`,);// Expected output: "The word "fox" is in the sentence"语法
js
includes(searchString)includes(searchString, position)参数
searchString一个要在
str中查找的字符串。不能是正则表达式。所有非正则表达式的值都会被强制转换为字符串，因此如果该参数被省略或传入undefined，includes()方法会在字符串中搜索"undefined"，这通常不是你想要的。position可选在字符串中开始搜索
searchString的位置。默认值为0。
返回值
如果在给定的字符串中找到了要搜索的字符串（包括searchString 为空字符串的情况），则返回true，否则返回false。
异常
描述
此方法可以帮你判断一个字符串是否包含另外一个字符串。
区分大小写
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")); // trueconsole.log(str.includes("question")); // trueconsole.log(str.includes("nonexistent")); // falseconsole.log(str.includes("To be", 1)); // falseconsole.log(str.includes("TO BE")); // falseconsole.log(str.includes("")); // true规范
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.prototype.includes |