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

【Node.js24.x】String::match()メソッドの使い方

matchメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

matchメソッドは、呼び出し元の文字列に対して、指定された正規表現パターンが一致するかどうかを調べ、その結果を配列として返すメソッドです。このメソッドは、文字列中から特定のパターンに合致する部分を見つけ出すために使用されます。

もし正規表現パターンに一致する部分が見つかった場合、matchメソッドは結果を配列として返します。この配列には、一致した文字列や、正規表現の設定に応じた詳細情報が含まれます。一方、文字列内に一致する部分が一つもなかった場合は、nullが返されます。

matchメソッドの動作は、使用する正規表現にg(グローバル)フラグが付いているかどうかで大きく異なります。

  • gフラグが付いていない場合:matchメソッドは、最初に見つかった一致のみを詳細な情報とともに配列として返します。この配列には、マッチした文字列全体、正規表現内で括弧で囲んで指定されたキャプチャグループ(部分パターン)、マッチが見つかった文字列中の開始インデックスなどの情報が含まれます。
  • gフラグが付いている場合:matchメソッドは、文字列内で見つかったすべての一致を検索し、それらのマッチした部分文字列のみを要素とするシンプルな配列として返します。この場合、各マッチの詳細な情報は含まれません。

したがって、文字列から特定のパターンに合致する部分を抽出したり、複数の該当箇所を一括で取得したりする際に、matchメソッドは非常に強力で便利な機能を提供します。

構文(syntax)

1const text = "Hello JavaScript, welcome to JavaScript world!";
2const matches = text.match(/JavaScript/);
3console.log(matches);

引数(parameters)

regexp

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

戻り値(return)

Array | null

指定された正規表現に一致した部分文字列の配列、または一致しなかった場合は null を返します。

関連コンテンツ

関連プログラミング言語