regExp.global vs while ループ vs matchAll メソッド

JavaScript の RegExp における regExp.global プロパティ

regExp.global プロパティは、正規表現オブジェクト (RegExp) の動作に影響を与えるフラグです。このフラグを設定すると、正規表現パターンが 複数回 一致するかどうかが変わります。

デフォルト動作

デフォルトでは、regExp.global は false に設定されています。つまり、正規表現パターンは 最初に見つかった箇所のみ 一致します。

例

以下のコードでは、str 変数内の "a" という文字が 最初に見つかった箇所のみ 一致し、match 変数には "a" が格納されます。

const str = "abcda";
const re = /a/;
const match = re.exec(str);

console.log(match); // ["a", index: 0, input: "abcda"]

regExp.global を true に設定

regExp.global を true に設定すると、正規表現パターンが すべての箇所 一致するようになります。

例

以下のコードでは、str 変数内の "a" という文字が すべての箇所 一致し、match 変数には ["a", "a", "a"] が格納されます。

const str = "abcda";
const re = /a/g;
const match = re.exec(str);

console.log(match); // ["a", "a", "a", index: 0, input: "abcda"]

注意点

• regExp.global を true に設定すると、ループ処理が発生するため、処理速度が遅くなる可能性があります。
• 複数回一致するパターンを処理する場合は、lastIndex プロパティも考慮する必要があります。

補足

• regExp.global は、exec() メソッドだけでなく、test() メソッドや replace() メソッドなどの他の RegExp メソッドにも影響を与えます。
• regExp.global は、正規表現リテラルでも設定できます。

例

const re = /a/g;
const str = "abcda";

console.log(re.test(str)); // true
console.log(str.replace(re, "-")); // "-bcd-"

JavaScript RegExp の regExp.global プロパティを使ったサンプルコード

複数回のマッチ

const str = "abcda";
const re = /a/g;

let match;
while ((match = re.exec(str)) !== null) {
  console.log(match.index);
}

出力結果：

0
1
3

特定のパターンをすべて置換

以下のコードは、str 変数内の "123" という文字列を すべて "456" に置換します。

const str = "abc123def123ghi";
const re = /123/g;

const newStr = str.replace(re, "456");

console.log(newStr); // abc456def456ghi

複数行にわたるマッチ

以下のコードは、str 変数内の複数行にわたって "abc" という文字列を すべて マッチし、その内容を出力します。

const str = `abc
def
abc
ghi`;
const re = /abc/g;

let match;
while ((match = re.exec(str)) !== null) {
  console.log(match[0]);
}

出力結果：

abc
abc

グループ化と置換

以下のコードは、str 変数内の電話番号を すべて マッチし、ハイフンで区切った形式に変換します。

const str = "電話番号: 090-1234-5678\n" +
            "メールアドレス: [email protected]\n" +
            "電話番号: 080-9876-5432";
const re = /電話番号:\s+(\d{3}-\d{4}-\d{4})/g;

const newStr = str.replace(re, "電話番号: $1");

console.log(newStr);

出力結果：

電話番号: 090-1234-5678
メールアドレス: [email protected]
電話番号: 080-9876-5432

JavaScript で複数回マッチする方法

while ループを使って、exec() メソッドを繰り返し呼び出す方法です。

const str = "abcda";
const re = /a/;

let match;
while ((match = re.exec(str)) !== null) {
  // マッチした内容を処理
  console.log(match[0]);
}

出力結果：

a
a
a

matchAll() メソッド

matchAll() メソッドは、正規表現パターンが すべて 一致する箇所をイテレータとして返します。

const str = "abcda";
const re = /a/g;

const matches = str.matchAll(re);

for (const match of matches) {
  // マッチした内容を処理
  console.log(match[0]);
}

出力結果：

a
a
a

replace() メソッド

replace() メソッドは、正規表現パターンに一致する箇所を すべて 置換することができます。

const str = "abc123def123ghi";
const re = /123/g;

const newStr = str.replace(re, "456");

console.log(newStr); // abc456def456ghi

ライブラリの使用

RegExLib などのライブラリを使うと、より複雑なパターンマッチングを簡単に実行できます。

const str = "abcda";
const re = /a/g;

const matches = RegExLib.FindAll(str, re);

for (const match of matches) {
  // マッチした内容を処理
  console.log(match);
}

出力結果：

{
  "index": 0,
  "input": "abcda",
  "groups": []
}
{
  "index": 1,
  "input": "abcda",
  "groups": []
}
{
  "index": 3,
  "input": "abcda",
  "groups": []
}

各方法の比較

どの方法を使うかは、状況によって異なります。 シンプルなパターンマッチングの場合は regExp.global や while ループが使いやすく、複雑なパターンマッチングの場合は matchAll メソッドやライブラリを使うと便利です。