Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【JavaScript ECMAScript】String::String.prototype.includesインスタンスメソッドの使い方

String.prototype.includes()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

String.prototype.includes()メソッドは、ある文字列が別の文字列の中に含まれているかどうかを判定し、その結果を真偽値で返すメソッドです。このメソッドは、JavaScriptの組み込みオブジェクトであるStringのインスタンスに対して使用できます。

具体的には、対象となる文字列(例えば「Hello World」)に対して、検索したい文字列(例えば「World」)が存在するかどうかを確認するために利用されます。検索したい文字列が見つかった場合はtrueを返し、見つからなかった場合はfalseを返します。

引数としては、必須で検索対象の文字列を指定します。さらにオプションとして、検索を開始する位置を数値で指定することも可能です。この位置を指定しなかった場合、文字列の最初(インデックス0)から検索が開始されます。例えば、「banana」という文字列のインデックス2以降で「an」を検索したい場合などに役立ちます。

このメソッドは、大文字と小文字を厳密に区別して検索を実行します。したがって、「JavaScript」という文字列の中から「javascript」を検索しようとするとfalseが返されます。文字列の存在チェックを簡潔に、かつ高い可読性で記述できるため、条件分岐などでの利用に非常に便利です。この機能はECMAScript 2015(ES6)で導入され、文字列の包含関係を直感的に判断できるため、現代のJavaScript開発において広く利用されています。

公式リファレンス: String.prototype.includes()

構文(syntax)

1"Hello, JavaScript".includes("Java");

引数(parameters)

searchString, position = 0

  • searchString: string: 検索したい文字列
  • position: number = 0: 検索を開始する位置(省略可能、デフォルトは0)

戻り値(return)

boolean

文字列内に指定した部分文字列が存在するかどうかを判定し、存在する場合はtrue、存在しない場合はfalseを返します。

関連コンテンツ

関連プログラミング言語