String.prototype.includes()

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。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"

構文

js
includes(searchString)
includes(searchString, position)

引数

searchString

str の中で検索される文字の集合です。正規表現にすることはできません。正規表現ではない値はすべて文字列に変換されますので、省略したり undefined を渡したりすると、includes() は "undefined" という文字列を検索します。これはおそらく望むところではないでしょう。

position 省略可

文字列内で searchString を検索し始める位置です。（既定値は 0 です。）

元の文字列と検索文字列の両方をすべて小文字に変換することで、この制約を回避することができます。

"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