【Node.js24.x】String::includes()メソッドの使い方
includesメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
includesメソッドは、ある文字列の中に指定された別の文字列（部分文字列）が含まれているかどうかを判定し、その結果を真偽値（trueまたはfalse）で返すメソッドです。このメソッドは、Webアプリケーションやシステム開発において、ユーザーからの入力検証やテキストコンテンツの検索、特定のキーワードの有無を確認する際など、文字列の内容に基づいて処理を分岐させる場面で非常に役立ちます。
このメソッドは通常、検索したい部分文字列を必須の第一引数として受け取ります。例えば、「JavaScriptは楽しい」という文字列が「Java」を含んでいるかを調べたい場合に使用します。もし検索対象の文字列内に部分文字列が見つかればtrueが、見つからなければfalseが戻り値として返されます。
任意で、第二引数としてposition（検索開始位置のインデックス）を指定することも可能です。このpositionを指定すると、文字列のその位置から検索を開始します。この引数は省略可能で、省略された場合は文字列の先頭（インデックス0）から検索が開始されます。
注意点として、includesメソッドは検索時に大文字・小文字を厳密に区別します。そのため、「Apple」という文字列に対して「apple」を検索してもfalseとなりますので、検索条件には注意が必要です。
構文(syntax)
const text = "Hello, Node.js developers!";
const containsNodejs = text.includes("Node.js");
console.log(containsNodejs);
引数(parameters)
searchString, position = 0
- searchString: string: 検索する文字列
- position: number = 0: 検索を開始する位置（省略可能、デフォルトは0）
戻り値(return)
boolean
指定された文字列が、この文字列に含まれているかどうかを示します。含まれている場合は true、含まれていない場合は false を返します。