本文へスキップ
FrAIFlow

トラブル解決 / テキスト・コード

JavaScriptの正規表現が1回おきに不一致になる理由

同じ入力なのに、検証に通った次は失敗し、その次はまた通る。入力を疑う前に正規表現を確認してください。使い回している正規表現にグローバルのgフラグがあると、lastIndexというカーソルを保持します。スティッキーのyフラグも状態を持ちます。

同じ入力でもカーソルが移動する仕組み
保存済みの例に基づく筆者作成の説明図です。アプリのスクリーンショットではありません。

交互に変わる結果の裏にあるカーソルを確認する

利用者が何も変更していないのに結果が交互に変わると、とても分かりにくくなります。初回の送信では受け付けられたコードが、2回目では拒否され、もう一度押すと通ることもあります。入力規則を変える前に、正規表現をどこで作っているか探してください。ハンドラーの外で保存したパターンは再利用されます。ハンドラーの中へ移すと問題が見えなくなることはありますが、原因の説明にはなりません。

ローカルのテストページかJavaScript実行環境で、一つの正規表現と無害な値を使って繰り返し呼び出します。各呼び出しの前後にカーソルを記録してください。

const check = /foo/g;
for (let attempt = 1; attempt <= 3; attempt++) {
  const before = check.lastIndex;
  const matched = check.test("foo");
  console.log({ attempt, before, matched, after: check.lastIndex });
}

一致後にカーソルが3へ進み、失敗後に0へ戻るはずです。次の試行は再び先頭から始まります。これで一見ランダムな動きが見えるようになります。診断の呼び出し自体も状態を進めるので、調査対象の動作を変えないよう使い捨ての正規表現で試してください。

2013年の公開相談でも、この交互の動作が報告されています。保存済みのNode.js v24.19.0の試験では、一つの正規表現と文字列で再現しました。

const pattern = /foo/g;
pattern.test("foo"); // true;  lastIndex = 3
pattern.test("foo"); // false; lastIndex = 0
pattern.test("foo"); // true;  lastIndex = 3

最初の一致でカーソルは末尾へ移動します。次はそこから探して何も見つからず、カーソルをリセットします。入力文字列を変えても自動的にはリセットされません。カーソルはRegExpオブジェクト自身の状態だからです。

入力検証と一致箇所の走査を分ける
保存済みの例に基づく筆者作成の説明図です。アプリのスクリーンショットではありません。

独立した入力検証には状態を持たせない

普通のフォーム検証なら、クリック処理の各所にリセットを散らすより、検証用の正規表現を一度直しましょう。大文字小文字を区別しないなど必要なフラグは残し、入力を毎回独立して調べるならグローバルやスティッキーは外します。変更前にコード内で同じオブジェクトを使う箇所を探してください。複数の一致を順に集める処理ではカーソルが本当に必要な場合があります。

以下のABC-1234の例は書式チェックであり、すべての識別子に使える規則ではありません。1行の値が必要なら改行を明示的に拒否します。JavaScriptの末尾アンカーには改行に関する細かな動作があり、複数行モードではさらに変わります。前後の空白をエラーにするか正規化して受け入れるかも決め、黙ってデータを変えず利用者に規則を伝えましょう。

const code = /^[A-Z]{3}-\d{4}$/;
["ABC-1234", "ABC-1234", "ABC-1234"]
  .map(value => code.test(value));
// [true, true, true]

意図的な走査とは処理を分ける

function independentTest(pattern, text) {
  pattern.lastIndex = 0;
  return pattern.test(text);
}

この関数は渡された正規表現を書き換えます。一致を順に追うためにカーソルを進めるループに入れてはいけません。走査と入力検証を併用するなら別々の正規表現にするほうが安全です。配列のコールバックもカーソルを自動リセットしません。

保存済みのテストではグローバルの正規表現で[true, false, true]となり、gなしの場合と明示的リセットを入れた場合は、どちらも3回ともtrueでした。これはNodeでの限定的な結果で、ブラウザー全般の互換性監査ではありません。状態を除いても失敗するなら、リセットを増やすのではなく、パターン、見えない文字、Unicodeに関する前提を調べてください。

実際のフォームでも直ったことを確かめる

同じ正しい値を数回試し、次に誤った値、その後また正しい値を試します。異なる正しい値を二つ続けて入力する試験も行ってください。結果は送信順ではなく、それぞれの値によって決まるべきです。実際のフォームでもこの短い手順を繰り返し、フォーカス移動時、入力中、送信時の検証が意図した規則を使うか確認します。

まだエラーが出るなら、正確な文字と残したフラグを確認します。万能の修正として呼び出しのたびにリセットを加えてはいけません。別の場所にある意図的な走査ループを壊すおそれがあります。一つの状態付きオブジェクトに二役を任せるより、検証と走査を分けるほうが理解しやすく保守も容易です。

記録された結果:trueでカーソル3、falseで0、次はtrueで3
既存の説明資料を保持しています。
同じ入力を繰り返した人工的な正規表現テストの記録
同じ入力に対するNode.js v24.19.0のRegExp.test結果です。記録済みテスト出力のキャプチャであり、元の相談者のアプリ画面ではありません。検証画像を原寸で開く。

出典・関連資料