replace 方法用於把字串中的某些內容換成另一些,或替換符合正則表達式的部分,回傳替換後的新字串。語法:
str_object.replace(reg_exp / str, replacement)
<script language="JavaScript">
var str = "www.example.net";
document.write( str.replace("example", "cnblogs") );
</script>輸出:
www.cnblogs.com
注意:字串模式只替換第一個符合的目標。若要全部替換,需改用帶 g 旗標的正則。
<script language="JavaScript"> var str = "www.example.net is a example domains site of INNA."; document.write( str.replace(/example/, "cnblogs") ); </script>
輸出:
www.cnblogs.com is a example domains site of INNA.
沒有 g 旗標,所以只換了第一處。
<script language="JavaScript"> var str = "www.example.net is a example domains site of INNA."; document.write( str.replace(/example/g, "cnblogs") ); </script>
輸出:
www.cnblogs.com is a cnblogs domains site of INNA.
兩處都被替換了。
若要忽略大小寫,加上 i 旗標:/example/gi。
這是 replace 最強大的用法,卻常被忽略。傳入函式時,可以對每個匹配項做動態處理:
var str = "a1b2c3";
// 把每個數字乘以 10
console.log(str.replace(/\d/g, function(match){
return Number(match) * 10;
}));
// 輸出 "a10b20c30"函式會收到多個參數:匹配內容、捕獲群組、偏移量、整個字串。利用捕獲群組可以做結構化的重組:
// 把 2024-01-15 換成 2024/01/15
console.log("2024-01-15".replace(
/(\d{4})-(\d{2})-(\d{2})/,
"$1/$2/$3"
));
// 或用函式寫法,語意更清楚
console.log("2024-01-15".replace(
/(\d{4})-(\d{2})-(\d{2})/,
function(m, y, mo, d){ return y + "/" + mo + "/" + d; }
));在替換字串中,$1、$2 代表捕獲群組,$& 代表整個匹配,$` 代表匹配前的部分,$' 代表匹配後的部分,$$ 代表字面的 $ 符號。
"aaa".replaceAll("a", "b")。注意 replaceAll 若傳入非全域的正則會丟出錯誤,這是刻意設計,用以避免「以為全換其實只換一個」的誤解。