跳至主要內容
FrAIFlow

問題解決指南 / 文字與程式碼

為什麼 JavaScript 正規表示式隔一次才通過驗證?

同一個欄位先通過驗證,沒有修改卻又失敗,再試一次又通過。責怪輸入之前,先檢查正規表示式。重複使用帶全域 g 旗標的表示式,會保留名為 lastIndex 的游標;黏著比對的 y 旗標也會保留狀態。

相同輸入,不斷移動的游標
依保留範例製作的說明圖,並非應用程式截圖。

讓交替結果背後的游標現形

這類交替錯誤特別令人困惑,因為使用者沒有做錯任何事。同一個代碼第一次送出被接受,第二次被拒絕,再點一次又成功。修改輸入規則前,先找到正規表示式在哪裡建立。放在處理函式外的模式會被重複使用;移到函式內可能掩蓋狀態問題,卻沒有說明原因。

在本機測試頁或 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 範例是一種格式檢查,不是所有識別碼的通用規則。如果只接受單行值,請明確拒絕換行。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 或每次明確重設時,都連續得到三次 true。這是針對性的 Node 測試,不是完整瀏覽器相容性稽核。如果移除狀態後仍失敗,應檢查模式、隱藏字元與 Unicode 假設,不要繼續增加重設操作。

透過實際表單確認修正

將相同的有效值測試數次,再測試無效值,最後再測有效值;也要連續測試兩個不同的有效值。答案應取決於每個值,而不是送出的順序。再透過實際表單重做這個小型序列,確認失去焦點、即時驗證與送出驗證都使用正確規則。

如果仍出現錯誤,請檢查實際字元與剩餘旗標。不要把「每次呼叫後重設」當通用解法,這可能破壞其他刻意掃描多個結果的迴圈。將驗證器與掃描器分開,比讓一個有狀態的物件兼做兩種工作更容易理解與維護。

實測序列:true 且游標 3,false 且游標 0,再 true 且游標 3。
保留的原始說明圖。
Node.js 比較紀錄:相同輸入得到 true、false、true,重設 lastIndex 後則為 true、true、true
Node.js v24.19.0 對重複相同輸入執行 RegExp.test 的保存結果。這是測試輸出畫面,不是原發問者的應用程式。開啟完整尺寸的證據圖片。

資料來源與延伸閱讀