replace() 僅替換第一個匹配項,除非搭配全域旗標 /g 的正則表達式;replaceAll()(ES2021)則直接替換所有匹配,語意更直觀。本文詳細解析參數、回呼函式用法、特殊替換變數,並提供 Polyfill 方案讓舊環境也能用上 replaceAll。
String.prototype.replace() 深度解析stringObj.replace(regexp|substr, newSubstr|function)
| 參數 | 型別 | 說明 |
|---|---|---|
| regexp | RegExp | 含 g 旗標時替換所有匹配;無 g 僅替換第一個 |
| substr | String | 字串字面值,僅替換第一次出現 |
| newSubstr | String | 替換字串,可使用特殊變數(見下表) |
| function | Function | 動態產生替換內容,參數依序為:完整匹配、捕獲組、位置、原字串 |
| 變數 | 含義 |
|---|---|
$$ | 插入單一 "$" |
$& | 完整匹配的子字串 |
$` | 匹配前的字串 |
$' | 匹配後的字串 |
$n | 第 n 個捕獲組(1-9) |
$nn | 第 nn 個捕獲組(01-99) |
// 1. 基本替換(僅第一個)
"The cat sat".replace("at", "ON"); // "The cON sat"
// 2. 全域替換(正則 + g 旗標)
"The cat sat".replace(/at/g, "ON"); // "The cON sON"
// 3. 使用捕獲組交換單詞順序
"John Smith".replace(/(\w+)\s(\w+)/, "$2, $1"); // "Smith, John"
// 4. 回呼函式:將攝氏轉華氏
"25C".replace(/(\d+)C/, (_, c) => `${Math.round(c * 9/5 + 32)}F`); // "77F"
// 5. 特殊變數應用:重複匹配內容
"abc".replace(/(\w)/g, "$&$&"); // "aabbcc"
replaceAll() (ES2021) —— 更直觀的全域替換// 語法
string.replaceAll(searchValue, replaceValue)
// 範例
"a-b-c".replaceAll("-", "_"); // "a_b_c"
// 也支援正則(需加 g 旗標,否則拋錯)
"a-b-c".replaceAll(/-/g, "_"); // "a_b_c"
注意:第一個參數若為正則,必須加 g 旗標,否則會拋出 TypeError。這是為了避免無意間只替換第一個匹配造成困惑。
if (!String.prototype.replaceAll) {
String.prototype.replaceAll = function(search, replace) {
// 字串搜尋:轉義特殊字元後加上 g 旗標
if (typeof search === 'string') {
search = search.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
}
// 正則:確保有 g 旗標
else if (search instanceof RegExp) {
if (!search.flags.includes('g')) {
search = new RegExp(search.source, search.flags + 'g');
}
}
return this.replace(search, replace);
};
}
在網址列輸入下列指令即可即時驗證正則替換結果:
javascript:alert("abcabcabc".replace(new RegExp("a","gm"),"ad"))
// 彈出視窗顯示:adbcadbcadbc
g 旗標:只會替換第一個匹配,導致「明明寫了正則卻只換一個」的假象。. * ?)的字串會被視為正則,建議用上述 Polyfill 的轉義邏輯。replace 與 replaceAll 行為:前者字串參數只換第一個,後者字串參數換全部;正則參數兩者皆需 g。現代專案優先使用 replaceAll() 提升可讀性;需支援舊瀏覽器時引入 Polyfill。掌握捕獲組與回呼函式,即能處理複雜字串轉換需求(如模板引擎、資料清洗、格式化輸出)。