本文へ移動
プログラミング大全動かして、比べて、理解する。

JavaScript / コードを試す

正規表現で探す — test() と match() と matchAll()

あるかどうかだけなら test()、取り出すなら match()、全部取り出すなら matchAll() です。 g フラグを付けたときに戻り値の形が変わること、test() が前回の位置を覚えてしまう罠まで確かめます。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

あるかどうかだけなら test() です。真偽値が返ります。

example.js

const hasDigit = /\d+/;

console.log(hasDigit.test('a12b'));
console.log(hasDigit.test('abc'));
固定例の期待出力 · Node 24.22.3
true
false
表示用コードUTF-8 · LF

取り出したいなら match() です。

example.js

console.log('a12b'.match(/\d+/));
console.log('abc'.match(/\d+/));
固定例の期待出力 · Node 24.22.3
[ '12' ]
null
表示用コードUTF-8 · LF

見つからないときは空配列ではなく nullです。そのまま [0] を読むと落ちます。

使い分け

したいこと 使うもの 見つからないとき
あるか無いか re.test(s) false
最初の1つを取り出す s.match(re) null
全部取り出す [...s.matchAll(re)] 空配列
位置だけ欲しい s.search(re) -1
置き換える s.replace(re, ...) 元のまま

null が返るのは match() だけです。ここが事故の起点になります。

example.js

const found = 'abc'.match(/\d+/);

console.log(found?.[0] ?? '見つからない');
固定例の期待出力 · Node 24.22.3
見つからない
表示用コードUTF-8 · LF

g を付けると戻り値の形が変わる

example.js

console.log('a12b34'.match(/\d+/));
console.log('a12b34'.match(/\d+/g));
固定例の期待出力 · Node 24.22.3
[ '12' ]
[ '12', '34' ]
表示用コードUTF-8 · LF

見た目は似ていますが中身が違います。

  • g なし … 最初の1つ。[0] が一致した文字列、[1] 以降がキャプチャ
  • g あり … 一致した文字列だけを並べた配列。キャプチャは消える

g を付けると「どこで一致したか」も「括弧の中身」も失われます。

全部を、中身つきで取り出す

matchAll() を使います。

example.js

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);
固定例の期待出力 · Node 24.22.3
2
[ 'a1', 'b22' ]
[ [ 'a', '1' ], [ 'b', '22' ] ]
0
表示用コードUTF-8 · LF

一致ごとに、キャプチャも位置も持ったまま取れます。 戻り値はイテレータなので、[...] で配列にしてから使います。

g を忘れると例外になります。

javascript失敗・注意の例

try {
  [...'a1'.matchAll(/\d/)];
} catch (error) {
  console.log(error.name);
}
固定例の期待出力 · Node 24.22.3
TypeError
表示用コードUTF-8 · LF

文言は「String.prototype.matchAll called with a non-global RegExp argument」(記事冒頭に示したNodeの版)。処理系によって変わります。

名前を付けて取り出す

(?<名前>…) と書くと、groups から引けます。

example.js

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);
固定例の期待出力 · Node 24.22.3
2026 09 08
2026-09-08
0
表示用コードUTF-8 · LF

番号で数えるより壊れにくくなります。 括弧を1つ足しただけで m[2] が別のものを指す、という事故が起きません。

いちばんの落とし穴:g 付きの test()

javascript失敗・注意の例

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);
固定例の期待出力 · Node 24.22.3
true 1
true 2
false 0
表示用コードUTF-8 · LF

同じ文字列を3回調べたのに、3回目だけ false です。

g 付きの正規表現は前回どこまで見たかを lastIndex に覚えています。 test() はそこから探し始めるので、呼ぶたびに結果が変わります。

g を外せば起きません。

example.js

const re = /a/;

console.log(re.test('aa'), re.test('aa'));
固定例の期待出力 · Node 24.22.3
true true
表示用コードUTF-8 · LF

「あるか無いか」を調べる正規表現に g は要りません。 使い回す正規表現を定数に置いているときほど当たりやすい罠です。

→ replace() と replaceAll()

特殊文字を打ち消す

. は「任意の1文字」です。そのまま書くと別の意味になります。

example.js

console.log('a.b'.replace(/\./g, '-'));
console.log('a.b'.replace(/./g, '-'));
固定例の期待出力 · Node 24.22.3
a-b
---
表示用コードUTF-8 · LF

文字列から正規表現を作るときは、さらに気をつけてください。

example.js

console.log(new RegExp('a.b').test('axb'));
console.log(new RegExp('a\\.b').test('axb'));
固定例の期待出力 · Node 24.22.3
true
false
表示用コードUTF-8 · LF

new RegExp() に渡すのは文字列なので、\ を打ち消すのに \\ が要ります。

利用者が入力した文字列を、そのまま正規表現にしないでください。 意図しない一致に加えて、書き方によっては処理が極端に遅くなることがあります。 探すだけなら includes() で足ります。

打ち消しを行う RegExp.escape() は、記事冒頭に示したNodeの版では利用できません。

よく使う形

example.js

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'));
固定例の期待出力 · Node 24.22.3
true
a b
a[1]b[2]
08/09/2026
表示用コードUTF-8 · LF
  • ^ と $ で全体が一致するかを見る(付けないと一部でも通る)
  • \s+ で連続した空白をまとめる
  • 置き換えに関数を渡せる
  • $1 でキャプチャを並べ替えられる

まとめ

  • あるか無いかは test()、取り出すなら match()、全部なら matchAll()
  • match() は見つからないと null。 ?. で守る
  • g を付けると match() の戻り値からキャプチャが消える
  • matchAll() は g が必須。位置もキャプチャも残る
  • g 付きの test() は呼ぶたびに結果が変わる(lastIndex)
  • 名前付きグループを使うと、括弧を足しても壊れない
  • 文字列から作るときは \\ で打ち消す。利用者の入力をそのまま渡さない

正規表現を使わずに済むなら、そのほうが読みやすくなります。 探すだけ・分けるだけの場面は、こちらにまとめてあります。 → 文字列を探す・分ける・置き換える

出典

この教材の原文(Markdown・別タブ)