文字列に指定の文字列が含まれているか検索する(includes)

String オブジェクトのインスタンスメソッドである includes は、対象の文字列に指定の文字列が含まれているか検索し true または false を返します。ここでは String オブジェクトの includes メソッドの使い方について解説します。

(Last modified: 2024-10-02)

文字列を検索する(includes)

String オブジェクトの includes メソッドは、対象の文字列に指定した文字列が含まれるかどうかを検索し、見つかった場合は true を、見つからなかった場合は false を返します。書式は次のとおりです。

文字列.includes(検索文字列 [, 開始インデックス])

最初の引数に検索する文字列を指定します。検索は対象の文字列の先頭から開始しますが、 2 番目の引数で検索を開始するインデックスを指定することもできます。見つかれば true を返し、見つからなかった場合は false が返ります。

次のサンプルをみてください。

let str = 'Blue Red Yellow';

console.log(str.includes('Red'));
>> true
console.log(str.includes('Red', 7));
>> false
console.log(str.includes('Green'));
>> false

対象の文字列には 'Red' は含まれているので true を返しますが、検索開始位置として 7 を指定した場合はそれ以降では 'Red' は見つからないため false が返されます。 'Green' は文字列に含まれていないので false が返されます。

-- --

String オブジェクトの includes メソッドの使い方について解説しました。

著者 / TATSUO IKURA

これから IT 関連の知識を学ばれる方を対象に、色々な言語でのプログラミング方法や関連する技術、開発環境構築などに関する解説サイトを運営しています。