DIV CSS 佈局教程網

透徹理解 replace():第二個參數是函式時,以及 $1、$& 這些符號
編輯:JavaScript綜合知識     

讀 jQuery 原始碼時,有個以前不曾注意的細節讓我卡住了:replace() 的第二個參數是函式時,到底該怎麼操作?以前只知道可以傳函式,卻從未真正用過。本文把這個問題與另一組相關的「怪符號」一起整理清楚。

基本語法

stringObject.replace(regexp/substr, replacement)

回傳一個新字串,其中 regexp 的第一次匹配(或全部匹配,若帶 g 旗標)已被 replacement 取代。

replacement 是函式時

當第二個參數是函式,每一個匹配都會呼叫該函式,函式回傳的字串作為該次匹配的替換文字。參數依序是:

  1. 匹配到的完整子字串。
  2. 接下來是與模式中各個捕獲組對應的字串,可能有 0 個或多個。
  3. 一個整數,代表匹配在原始字串中出現的位置(offset)。
  4. 最後一個參數是原始字串本身。

用實例看清參數順序

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 就會落在第二個參數上。

jQuery 原始碼中的實際用法

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- 後面的字母大寫化——兩步組合起來,就能處理各家瀏覽器前綴的各種寫法差異。

另一組符號:$1、$2、$& 等

除了函式,替換字串本身也支援一組特殊符號:

$1、$2、$3……表示第 n 個捕獲組

var string = "abc123-ii";
console.log(string.replace(/(\d)-([a-z])/g, "$1"));
// 用捕獲組 1("3")取代整個匹配

$& 表示與 regexp 匹配的整個子串

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")。
  • 需要依內容做條件判斷或計算 → 只能用函式,例如依金額大小加不同符號。
  • 需要用到 offset 或原始字串 → 只能用函式。
// 用函式做條件替換
"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。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved