RegExp.testが交互にtrue・falseになる理由｜gフラグとlastIndex

数字だけの文字列を確認しているのに、同じ"42"が通ったり落ちたりする。正規表現の使い回しで起きるこの症状は、パターン末尾のgフラグが原因かもしれません。

gやyを付けた正規表現は、次に調べる位置をlastIndexに保持します。単に入力が条件に合うかを毎回独立して確認したいなら、不要なg・yを外すのが分かりやすい修正です。

まずは手元で再現する

実行用サンプルを開く・保存するから、regexp-last-index.mjsという名前で保存して実行してください。

node regexp-last-index.mjs

確認環境はNode.js v24.14.0です。追加パッケージ、アカウント、ネットワーク通信、ファイルの書き込みは不要です。最後に「すべての実行例が期待値と一致しました。」と出れば、繰り返し判定、修正後の判定、空の一致まで確認できています。以下のJavaScriptの枠も、それぞれ別の.mjsファイルで実行できます。

同じ文字列でも、開始位置が変わっている

const pattern = /^[0-9]+$/g;
for (const input of ['42', '42', '42']) {
  console.log(pattern.test(input), pattern.lastIndex);
}
// true 2
// false 0
// true 2

このパターンは、先頭から末尾までが半角数字であることを調べます。文字列は変えていませんが、正規表現オブジェクトの状態が変わります。

呼び出し	開始時の位置	結果と次の位置
1回目	0	一致してtrue、位置は2
2回目	2	一致せずfalse、位置は0
3回目	0	一致してtrue、位置は2

g付きでは、成功するとlastIndexが一致した末尾へ移ります。次の呼び出しはその位置から探すため、2回目は先頭に一致するこのパターンを満たせません。失敗すると位置が0に戻り、3回目は再び通ります。ECMAScriptの正規表現実行規則

入力を別の文字列に変えても、自動で位置が初期化されるわけではありません。実行用サンプルでは、同じ正規表現で"12"を調べた直後に"34"を調べると、後者がfalseになることも確認しています。MDNのtest解説

入力チェックなら、不要なgとyを外す

半角数字だけの文字列かどうかを判定するなら、次のように書けます。

const digits = /^[0-9]+$/;
const isDigits = (value) => typeof value === 'string' && digits.test(value);

console.log(['42', '42', '42'].map(isDigits).join(',')); // true,true,true
console.log(isDigits('4x'));  // false
console.log(isDigits('４２')); // false
console.log(isDigits(''));    // false
console.log(isDigits(42));    // false
console.log(digits.test(42)); // true

ここでは「半角数字が1文字以上ある文字列」を受け付け、数値の42は受け付けない方針にしています。test()は引数を文字列に変換するため、型も限定したい場合は先にtypeofで確認します。型の確認と正規表現の確認は別の役割です。RegExp.testの引数

実行用サンプルでは、末尾に改行のある"42\n"や、null、undefinedも拒否することを照合しています。これは上のパターンと条件での結果であり、フラグやパターンを変えた場合の入力ルールまで保証するものではありません。

既存の処理でg付きの正規表現を使う必要があるなら、各入力を調べる前にpattern.lastIndex = 0と戻す方法もあります。ただし、その後のtest()でまた状態は変わります。入力チェックだけなら、位置を持たせない方が扱いやすくなります。

yへ変えれば直る、というわけではない

yもlastIndexを使うフラグです。違いは、gが後ろの位置も探すのに対し、yは指定位置から一致する必要があることです。

const global = /[0-9]/g;
const sticky = /[0-9]/y;
console.log(global.test('x7'), global.lastIndex); // true 2
console.log(sticky.test('x7'), sticky.lastIndex); // false 0
sticky.lastIndex = 1;
console.log(sticky.test('x7'), sticky.lastIndex); // true 2

位置0にはxがあるので、yでは一致しません。位置1を指定すれば7に一致します。これは文字列を位置に沿って読み進める用途で意味のある違いです。毎回独立した入力判定をしたい場面で、gをyへ置き換えるだけでは解決しません。RegExpBuiltinExecのglobalとstickyの分岐

trueでも位置が進まない例がある

正確には、成功したときに位置が「必ず増える」のではなく、「一致した末尾になる」という規則です。文字を消費しない一致なら、位置は増えません。

const pattern = /^/g;
console.log(pattern.test('42'), pattern.lastIndex); // true 0
console.log(pattern.test('42'), pattern.lastIndex); // true 0

このパターンは先頭という位置に一致するため、末尾も0のままです。while (pattern.test(text))のような書き方をするとき、trueなら自動で前進すると考えるのは危険です。

まず、入力が条件を満たすかを確認したいのか、一致箇所を順番に読みたいのかを分けましょう。前者なら不要なg・yを外す。後者なら開始位置と、空の一致をどう扱うかまで決める。この区別が、繰り返したときだけ結果が変わる不具合を直す手掛かりになります。