JavaScript 的字串替換方法 replace 預設只換第一個符合項,這點和許多語言不同。要達到「全部替換」的效果,關鍵是把搜尋目標包成正則表達式並加上 g 旗標。
string.replace(new RegExp(oldString, "gm"), newString);
g 是 global(全域),m 是 multiLine(多行模式)。兩者作用不同,需要視情況選用:
g 讓比對不中斷,換掉所有符合項,這是「replaceAll」真正需要的旗標。m 則是改變 ^ 與 $ 的意義——加了之後,它們會匹配每一行的開頭與結尾,而不只是整份字串的開頭結尾。如果你的替換目標裡沒有 ^ 或 $,加 m 沒有任何效果。
最快的測試方式是在瀏覽器網址列直接執行:
javascript:alert("abcabcabc".replace(new RegExp("a", "gm"), "ad"))
會得到 adbcdabcbc 之類的結果(視實際比對而定),不必開除錯器就能確認行為。不過要注意,現代瀏覽器為了安全,多數會把網址列中以 javascript: 開頭的內容直接貼上時剝除,可能需要手動輸入或改用主控台。
用字串建構正則時,那個字串本身要先被解析成「正則原始碼」。這帶來兩個問題。
第一,特殊字元沒被轉義。若 oldString 是 "a.b",其中的 . 在正則裡代表「任意字元」,於是 aXb 也會被換掉。要當成純文字處理,必須先轉義:
function escapeRegExp(str) {
return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
}
"axb-a.b".replace(new RegExp(escapeRegExp("a.b"), "g"), "X"); // axb-X
第二,若 oldString 來自使用者輸入,未轉義的正則可能造成 ReDoS(正則阻斷服務攻擊)——某些構造會讓引擎回溯指數級增加,直接把分頁卡死。
如果替換目標是純字串,直接用 split 加 join 反而最簡單,也完全沒有轉義問題:
str.split("a.b").join("X");
若環境支援(ES2021 之後已是標準),有專門的方法可用:
str.replaceAll("a.b", "X"); // 純字串,不需轉義
str.replaceAll(/a\.b/g, "X"); // 正則必須帶 g,否則丟 TypeError
replaceAll 的第一個參數若傳正則,就必須帶 g 旗標,否則會直接丟出 TypeError——這是刻意設計的,因為不帶 g 的 replaceAll 與 replace 行為完全相同,容易讓人誤以為出了 bug。
最後補充一個常用技巧:替換時若想在上限次數內進行,可以用回呼並自行計數:
var count = 0;
str.replace(/a/g, function (m) {
if (count >= 3) return m; // 超過上限就原樣保留
count++;
return "X";
});
這比切字串拼接可讀得多,也不必擔心 $1 這類特殊替換符號的干擾。