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

【JavaScript ECMAScript】RegExp::RegExp.prototype[Symbol.matchAll]インスタンスメソッドの使い方

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

作成日: 更新日:

基本的な使い方

RegExp.prototypeSymbol.matchAllメソッドは、JavaScriptにおいて正規表現が文字列内の全てのマッチを検出するための内部ロジックを提供するメソッドです。このメソッドは、主にString.prototype.matchAll()メソッドが正規表現オブジェクトを受け取った際に、その正規表現がどのようにマッチングを実行するかを定義するために使用されます。

具体的には、与えられた文字列に対して正規表現パターンに合致する全ての部分を検索し、その結果をイテレータとして返します。イテレータとは、for...ofループなどで、マッチ結果を一つずつ順番に取り出すことができる特殊なオブジェクトのことです。これにより、複数見つかったマッチ結果を効率的かつ柔軟に処理することが可能になります。

各マッチ結果は、見つかった部分文字列、文字列中での開始位置のインデックス、正規表現のキャプチャグループの情報などを含む配列のような形式で提供されます。このメソッドは、正規表現のグローバルフラグ(gフラグ)の有無に関わらず、常に文字列内の全てのマッチを探し出します。これにより、開発者は文字列中の関連する全ての情報を網羅的に抽出できます。

システムエンジニアを目指す方にとって、大量のテキストデータから特定のパターンを抽出したり、データを解析したりする場面で、この強力な正規表現の機能は不可欠です。RegExp.prototypeSymbol.matchAllメソッドは、より高度な文字列処理を効率的に実装するための基盤となります。

公式リファレンス: RegExp.prototype[Symbol.matchAll]()

構文(syntax)

1const regex = /t(e)(st(\d?))/g;
2const str = 'test1test2';
3
4for (const match of regex[Symbol.matchAll](str)) {
5  console.log(match);
6}

引数(parameters)

string

  • string: マッチング操作を実行する対象の文字列

戻り値(return)

RegExpStringIterator のインスタンス

RegExp.prototype[Symbol.matchAll]() メソッドは、正規表現にマッチするすべての結果を格納した RegExpIterator のインスタンスを返します。このイテレータは、マッチした各部分文字列やキャプチャグループなどを順番に取り出すことができます。

関連コンテンツ

関連プログラミング言語