JavaScript / コードを試す
正規表現で探す — test() と match() と matchAll()
あるかどうかだけなら test()、取り出すなら match()、全部取り出すなら matchAll() です。 g フラグを付けたときに戻り値の形が変わること、test() が前回の位置を覚えてしまう罠まで確かめます。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
あるかどうかだけなら test() です。真偽値が返ります。
const hasDigit = /\d+/; console.log(hasDigit.test('a12b')); console.log(hasDigit.test('abc'));
true false
取り出したいなら match() です。
console.log('a12b'.match(/\d+/)); console.log('abc'.match(/\d+/));
[ '12' ] null
見つからないときは空配列ではなく nullです。そのまま [0] を読むと落ちます。
使い分け
| したいこと | 使うもの | 見つからないとき |
|---|---|---|
| あるか無いか | re.test(s) |
false |
| 最初の1つを取り出す | s.match(re) |
null |
| 全部取り出す | [...s.matchAll(re)] |
空配列 |
| 位置だけ欲しい | s.search(re) |
-1 |
| 置き換える | s.replace(re, ...) |
元のまま |
null が返るのは match() だけです。ここが事故の起点になります。
const found = 'abc'.match(/\d+/); console.log(found?.[0] ?? '見つからない');
見つからない
g を付けると戻り値の形が変わる
console.log('a12b34'.match(/\d+/)); console.log('a12b34'.match(/\d+/g));
[ '12' ] [ '12', '34' ]
見た目は似ていますが中身が違います。
gなし … 最初の1つ。[0]が一致した文字列、[1]以降がキャプチャgあり … 一致した文字列だけを並べた配列。キャプチャは消える
g を付けると「どこで一致したか」も「括弧の中身」も失われます。
全部を、中身つきで取り出す
matchAll() を使います。
const found = [...'a1b22c'.matchAll(/(\w)(\d+)/g)]; console.log(found.length); console.log(found.map((m) => m[0])); console.log(found.map((m) => [m[1], m[2]])); console.log(found[0].index);
2 [ 'a1', 'b22' ] [ [ 'a', '1' ], [ 'b', '22' ] ] 0
一致ごとに、キャプチャも位置も持ったまま取れます。
戻り値はイテレータなので、[...] で配列にしてから使います。
g を忘れると例外になります。
try {
[...'a1'.matchAll(/\d/)];
} catch (error) {
console.log(error.name);
}TypeError
文言は「String.prototype.matchAll called with a non-global RegExp argument」(記事冒頭に示したNodeの版)。処理系によって変わります。
名前を付けて取り出す
(?<名前>…) と書くと、groups から引けます。
const m = '2026-09-08'.match(/(?<y>\d{4})-(?<mo>\d{2})-(?<d>\d{2})/); console.log(m.groups.y, m.groups.mo, m.groups.d); console.log(m[0]); console.log(m.index);
2026 09 08 2026-09-08 0
番号で数えるより壊れにくくなります。
括弧を1つ足しただけで m[2] が別のものを指す、という事故が起きません。
いちばんの落とし穴:g 付きの test()
const re = /a/g;
console.log(re.test('aa'), re.lastIndex);
console.log(re.test('aa'), re.lastIndex);
console.log(re.test('aa'), re.lastIndex);true 1 true 2 false 0
同じ文字列を3回調べたのに、3回目だけ false です。
g 付きの正規表現は前回どこまで見たかを lastIndex に覚えています。
test() はそこから探し始めるので、呼ぶたびに結果が変わります。
g を外せば起きません。
const re = /a/; console.log(re.test('aa'), re.test('aa'));
true true
「あるか無いか」を調べる正規表現に g は要りません。
使い回す正規表現を定数に置いているときほど当たりやすい罠です。
特殊文字を打ち消す
. は「任意の1文字」です。そのまま書くと別の意味になります。
console.log('a.b'.replace(/\./g, '-')); console.log('a.b'.replace(/./g, '-'));
a-b ---
文字列から正規表現を作るときは、さらに気をつけてください。
console.log(new RegExp('a.b').test('axb')); console.log(new RegExp('a\\.b').test('axb'));
true false
new RegExp() に渡すのは文字列なので、\ を打ち消すのに \\ が要ります。
利用者が入力した文字列を、そのまま正規表現にしないでください。 意図しない一致に加えて、書き方によっては処理が極端に遅くなることがあります。 探すだけなら
includes()で足ります。
打ち消しを行う RegExp.escape() は、記事冒頭に示したNodeの版では利用できません。
よく使う形
console.log(/^\d{3}-\d{4}$/.test('123-4567')); console.log(' a b '.replace(/\s+/g, ' ').trim()); console.log('a1b2'.replace(/\d/g, (d) => '[' + d + ']')); console.log('2026-09-08'.replace(/(\d{4})-(\d{2})-(\d{2})/, '$3/$2/$1'));
true a b a[1]b[2] 08/09/2026
^と$で全体が一致するかを見る(付けないと一部でも通る)\s+で連続した空白をまとめる- 置き換えに関数を渡せる
$1でキャプチャを並べ替えられる
まとめ
- あるか無いかは
test()、取り出すならmatch()、全部ならmatchAll() match()は見つからないとnull。?.で守るgを付けるとmatch()の戻り値からキャプチャが消えるmatchAll()はgが必須。位置もキャプチャも残るg付きのtest()は呼ぶたびに結果が変わる(lastIndex)- 名前付きグループを使うと、括弧を足しても壊れない
- 文字列から作るときは
\\で打ち消す。利用者の入力をそのまま渡さない
正規表現を使わずに済むなら、そのほうが読みやすくなります。 探すだけ・分けるだけの場面は、こちらにまとめてあります。 → 文字列を探す・分ける・置き換える