萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript replace 與 replaceAll 完整實戰指南

核心差異一覽

replace() 僅替換第一個匹配項,除非搭配全域旗標 /g 的正則表達式;replaceAll()(ES2021)則直接替換所有匹配,語意更直觀。本文詳細解析參數、回呼函式用法、特殊替換變數,並提供 Polyfill 方案讓舊環境也能用上 replaceAll。

String.prototype.replace() 深度解析

語法

stringObj.replace(regexp|substr, newSubstr|function)

參數說明

參數型別說明
regexpRegExp含 g 旗標時替換所有匹配;無 g 僅替換第一個
substrString字串字面值,僅替換第一次出現
newSubstrString替換字串,可使用特殊變數(見下表)
functionFunction動態產生替換內容,參數依序為:完整匹配、捕獲組、位置、原字串

特殊替換變數(僅在字串替換模式生效)

變數含義
$$插入單一 "$"
$&完整匹配的子字串
$`匹配前的字串
$'匹配後的字串
$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。這是為了避免無意間只替換第一個匹配造成困惑。

舊環境 Polyfill:為 String 原型擴充 replaceAll

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。掌握捕獲組與回呼函式,即能處理複雜字串轉換需求(如模板引擎、資料清洗、格式化輸出)。

copyright © 萬盛學電腦網 all rights reserved