導入：なぜSymbol.matchAllが重要なのか
JavaScriptで文字列の中から特定のパターンをすべて抽出したいとき、これまで皆さんはどのように実装していましたか？従来のexecループ処理はコードが冗長になりがちで、バグも混入しやすいという課題がありました。Symbol.matchAll（およびそれに関連するmatchAllメソッド）を活用することで、正規表現の結果をイテレータとして美しく処理できるようになります。今回は、この強力なツールを使って「読みやすく、効率的な」文字列操作を実現する方法を解説します。
基礎知識：正規表現とイテレータ
まず、正規表現（RegExp）は文字列のパターンを見つけるためのルールです。そしてイテレータとは、データの集まりを一つずつ順番に取り出すための仕組みのことです。
通常、正規表現でマッチしたものをすべて取得するには「g（グローバル）」フラグが必要ですが、これを扱うためにSymbol.matchAllが存在します。これは、正規表現オブジェクトが「matchAllメソッドが呼び出されたときにどう振る舞うか」を定義するための特別なキーです。私たちが直接このSymbolを呼び出す機会は少ないですが、String.prototype.matchAllが内部でこれを参照することで、マッチした結果を効率的にループ処理できるようになっています。
実装：matchAllの使い方
matchAllを使うと、マッチした結果を「配列の集まり」として取得できます。これまでのexecメソッドのようにインデックスを管理する必要はなく、for…ofループで直感的に回すことができます。
サンプルプログラム
以下のコードは、文章の中から「#」で始まるハッシュタグをすべて抽出する実用的な例です。そのままコピーしてブラウザのコンソールなどで実行してみてください。
// 抽出したい対象のテキスト
const text = "今日は #フロントエンド の勉強会。#JavaScript は楽しい！";
// gフラグ付きの正規表現（重要：gがないとエラーになります）
const regex = /#(\w+)/g;
// matchAllを使って、マッチした結果をすべて取得
// 結果はイテレータとして返されます
const matches = text.matchAll(regex);
// for...ofループで一つずつ取り出す
for (const match of matches) {
// match[0] はマッチした文字列全体 (#フロントエンド)
// match[1] はカッコで囲ったキャプチャグループ (フロントエンド)
console.log(`見つかったタグ: ${match[0]}`);
console.log(`タグ名のみ: ${match[1]}`);
console.log(`出現位置: ${match.index}`);
}
応用・注意点：現場でハマらないために
1. gフラグを忘れずに: matchAllはグローバル検索を前提としているため、正規表現にgフラグがついていないとTypeErrorが発生します。必ず正規表現の末尾にgを付けましょう。
2. イテレータの性質: matchAllが返すのは配列ではなくイテレータです。もしマッチした結果をすべて一度に配列として扱いたい場合は、[…text.matchAll(regex)] のようにスプレッド構文を使って配列に変換してください。
3. キャプチャグループの活用: サンプルコードの通り、正規表現を括弧で囲む（キャプチャグループ）ことで、match[1]以降に特定のパーツだけを抽出できます。これがmatchAllの最大の強みです。
これらを使いこなすことで、複雑な文字列解析も非常にシンプルに書けるようになります。ぜひ次回のプロジェクトで試してみてください！