String 的 replace 函式簽名如下:
replace(match /* 字串或正則表達式 */, replacement /* 字串或函式 */)
作用是將字串中的 match 替換為 replacement,並回傳替換後的新字串。
沒什麼好說的,但務必記住:此時只會替換第一次出現的那一處,函式就執行完畢了。
"aaa".replace("a", "b"); // "baa",只換第一個
要全域替換,第一個參數必須用正則並加上 g 旗標:
"aaa".replace(/a/g, "b"); // "bbb"
字串中可以引用第一個參數正則的分組:
"aaaa".replace(/(a){2,2}/g, "$1b"); // 將所有的 aa 替換為 ab
可用的特殊符號包括 $1~$99(第 n 個分組)、$&(整個比對結果)、$`(比對前的部分)、$'(比對後的部分)與 $$(字面值 $)。
那麼函式會收到哪些參數?
"bbabc".replace(/(a)(b)/g, function(){
console.log(arguments);
});
參數依序為:
所以上例的輸出是:
["ab", "a", "b", 2, "bbabc"]
函式的回傳值會被替換進結果字串中。由於 JavaScript 函式若無回傳值會得到 undefined,因此若忘了回傳,字串中就會出現字面的 "undefined"。
"bbabc".replace(/(a)(b)/g, function(m, p1, p2, offset, str){
return "[" + m + "@" + offset + "]";
});
// "bb[ab@2]"
若第一個參數是字串,同時第二個參數是函式,那就當成「一個沒有分組的正則表達式」來理解即可,參數規則不變(此時只有第 1、3、4 個參數有意義)。
依內容決定替換結果。
"a1b2c3".replace(/\d/g, function(d){
return "<span>" + d + "</span>";
});
大小寫轉換。
"hello world".replace(/\w+/g, function(w){
return w.charAt(0).toUpperCase() + w.slice(1);
});
// "Hello World"
參數改名(同時用到 offset 與原字串)。
"user=amy&age=30".replace(/(\w+)=(\w*)/g, function(m, key, val, offset, str){
return key + ": " + val;
});
常有人說「替換到原始字串中」——這個說法並不精準。字串在 JavaScript 中是不可變的,replace 不會修改原本的字串,只是以它為模板計算出一個新字串並回傳。若不把回傳值接住,等於什麼都沒做。
var s = "aaa";
s.replace(/a/g, "b");
console.log(s); // 仍然是 "aaa"
另外,ES2021 之後有了 replaceAll(),可以用字串直接做全域替換而不必寫正則,語意更清楚:
"aaa".replaceAll("a", "b"); // "bbb"