このページはコミュニティーの尽力で英語から翻訳されました。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月.
includes() はString 値のメソッドで、大文字と小文字を区別して検索を行い、指定された文字列がこの文字列内で見つかるかどうかを判断し、必要に応じて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`,);// 予想される結果: "The word "fox" is in the sentence"構文
includes(searchString)includes(searchString, position)引数
searchStringstrの中で検索される文字の集合です。正規表現にすることはできません。正規表現ではない値はすべて文字列に変換されますので、省略したりundefinedを渡したりすると、includes()は"undefined"という文字列を検索します。これはおそらく望むところではないでしょう。position省略可文字列内で
searchStringを検索し始める位置です。（既定値は0です。）
返値
検索文字列が指定された文字列の中で見つかった場合、searchString が空文字列の場合はtrue。そうでなければfalse です。
例外
TypeErrorsearchStringが正規表現であった場合に発生します。
解説
このメソッドで、ある文字列が別な文字列の中に含まれているかどうかを判断することができます。
大文字小文字の区別
includes() メソッドは大文字と小文字が区別します。例えば、次のコードではfalse を返します。
"Blue Whale".includes("blue"); // false を返す元の文字列と検索文字列の両方をすべて小文字に変換することで、この制約を回避することができます。
"Blue Whale".toLowerCase().includes("blue"); // true を返す例
includes() の使用
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 |