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

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

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

作成日: 更新日:

基本的な使い方

String.prototype.match()メソッドは、指定された正規表現と文字列を比較し、マッチした部分を検索・抽出するメソッドです。このメソッドは、JavaScriptの文字列オブジェクトが持つ機能の一つで、文字列の中から特定のパターンを見つけ出す際に利用されます。

引数には、検索したいパターンを表すRegExpオブジェクト(正規表現オブジェクト)か、正規表現として解釈される文字列を渡します。正規表現とは、特定の文字の並びや繰り返しなどを表現するための強力なパターン記述方法です。

パターンに一致する部分が見つかった場合、このメソッドはマッチに関する情報を含む配列を返します。この配列には、マッチした文字列自体はもちろん、マッチした位置を示すindexプロパティや、元の入力文字列を示すinputプロパティなどが含まれることがあります。また、正規表現にg(グローバル)フラグが設定されている場合は、文字列内で見つかった全てのマッチが配列要素として返されます。gフラグがない場合は、最初に見つかったマッチの情報のみが返され、その情報はRegExp.prototype.exec()メソッドの戻り値と似た形式になります。

もしパターンに一致する部分が一つも見つからない場合は、nullを返します。したがって、特定のキーワードの有無を確認したり、文字列から特定の形式のデータを抽出したりする際に非常に役立ちます。例えば、メールアドレスの形式を検証したり、URLから特定のパラメータを抽出したりする場面で活用できます。システムエンジニアを目指す上で、文字列処理は基礎となる技術であり、match()メソッドはその中心的な役割を果たすものの一つです。

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

構文(syntax)

1const targetString = "Hello JavaScript!";
2const matchResult = targetString.match(/Java/);

引数(parameters)

regexp

  • regexp: RegExp: マッチングに使用する正規表現オブジェクト。または、正規表現パターンを表す文字列。

戻り値(return)

Array | null

指定された正規表現に一致した検索結果を配列として返します。一致しない場合は null を返します。

関連コンテンツ

関連プログラミング言語