為什麼 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 假設,不要繼續增加重設操作。
透過實際表單確認修正
將相同的有效值測試數次,再測試無效值,最後再測有效值;也要連續測試兩個不同的有效值。答案應取決於每個值,而不是送出的順序。再透過實際表單重做這個小型序列,確認失去焦點、即時驗證與送出驗證都使用正確規則。
如果仍出現錯誤,請檢查實際字元與剩餘旗標。不要把「每次呼叫後重設」當通用解法,這可能破壞其他刻意掃描多個結果的迴圈。將驗證器與掃描器分開,比讓一個有狀態的物件兼做兩種工作更容易理解與維護。
