讀 jQuery 原始碼時,有個以前不曾注意的細節讓我卡住了:replace() 的第二個參數是函式時,到底該怎麼操作?以前只知道可以傳函式,卻從未真正用過。本文把這個問題與另一組相關的「怪符號」一起整理清楚。
stringObject.replace(regexp/substr, replacement)
回傳一個新字串,其中 regexp 的第一次匹配(或全部匹配,若帶 g 旗標)已被 replacement 取代。
當第二個參數是函式,每一個匹配都會呼叫該函式,函式回傳的字串作為該次匹配的替換文字。參數依序是:
var string = "abc123-ii";
string.replace(/(\d)-([a-z])/g, function (str1, str2, str3, str4, str5) {
console.log(str1); // "3-i" ← 完整匹配
console.log(str2); // "3" ← 第一個捕獲組
console.log(str3); // "i" ← 第二個捕獲組
console.log(str4); // 5 ← 匹配的起始位置
console.log(str5); // "abc123-ii" ← 原始字串
return "I";
});
把這個輸出跟上面的規則對照,一切就清楚了。要注意參數個數是「1 + 捕獲組數量 + 2」,所以捕獲組數量會直接影響後面參數的位置——如果模式沒有捕獲組,那 offset 就會落在第二個參數上。
camelCase: function (string) {
return string.replace(rmsPrefix, "ms-").replace(rdashAlpha, fcamelCase);
},
fcamelCase = function (all, letter) {
return letter.toUpperCase();
};
這段做什麼?rdashAlpha 匹配「連字號加一個字母」,而 fcamelCase 只取第二個參數(捕獲到的字母)並轉成大寫,於是 -ms-transform 之類的寫法就被轉成駝峰式 msTransform。第一個參數 all 雖然沒被用到,但因為它在第一位,必須寫出來才能拿到後面的捕獲組。
第一次 replace 先把前綴 -ms- 統一成 ms-,第二次再把 ms- 後面的字母大寫化——兩步組合起來,就能處理各家瀏覽器前綴的各種寫法差異。
除了函式,替換字串本身也支援一組特殊符號:
var string = "abc123-ii";
console.log(string.replace(/(\d)-([a-z])/g, "$1"));
// 用捕獲組 1("3")取代整個匹配
console.log(string.replace(/(\d)-([a-z])/g, "$&"));
// 用匹配字串本身("3-i")取代,等同於不做變化
實務上常搭配前後文使用,例如 "[$&]" 會把匹配項用中括號包起來。
console.log(string.replace(/(\d)-([a-z])/g, "$`"));
// 用匹配子串左側的文本("abc12")取代
console.log(string.replace(/(\d)-([a-z])/g, "$'"));
// 用匹配子串右側的文本取代
console.log(string.replace(/(\d)-([a-z])/g, "$$"));
// 用 $ 符號取代
兩種方式可以互相替換,選擇依據是可讀性:
$1、$2 最簡潔,例如把 "2024-01-15" 轉成 "15/01/2024":str.replace(/(\d{4})-(\d{2})-(\d{2})/, "$3/$2/$1")。// 用函式做條件替換
"price: 80, price: 150".replace(/price: (\d+)/g, function (m, num) {
return "price: " + (num > 100 ? num * 0.9 : num);
});
如果只是想「第一次出現才替換」,把 g 旗標拿掉即可;若想「全部替換但用字串而非正則」,可以直接用 replaceAll()(ES2021 起),它接受字串參數並預設全域替換,比構造正則更直觀。但要注意 replaceAll 的第一個參數若是正則,必須帶 g 旗標,否則會拋出 TypeError。