萬盛學電腦網

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

JavaScript 字串替換:replace() 與 replaceAll() 完整教學

前言

replace() 是字串替換的基礎方法,但預設**只替換第一個匹配**。ES2021 新增 replaceAll() 可一次替換所有匹配。本文詳細說明兩者語法、正則運用與常見陷阱。

replace() 基本語法

str.replace(searchFor, replaceWith)
  • searchFor:字串或正則表達式。字串時只替換第一個匹配。
  • replaceWith:替換字串或函式。
  • 回傳:新字串,原字串不變。

replaceAll() 語法 (ES2021)

str.replaceAll(searchFor, replaceWith)
  • searchFor:字串或**全域正則 (帶 g 旗標)**。字串時替換所有匹配。
  • 其餘行為同 replace()。

實戰範例

範例 1:字串參數只替第一個

const str = 'Visit Microsoft! Visit Microsoft!';
console.log(str.replace('Microsoft', 'jb51.net'));
// "Visit jb51.net! Visit Microsoft!"

範例 2:正則全域旗標替換所有

console.log(str.replace(/Microsoft/g, 'jb51.net'));
// "Visit jb51.net! Visit jb51.net!"

範例 3:replaceAll 直接替換所有 (推薦)

console.log(str.replaceAll('Microsoft', 'jb51.net'));
// "Visit jb51.net! Visit jb51.net!"

範例 4:替換函式動態生成結果

const str = 'apple, banana, apple';
const result = str.replaceAll('apple', (match, offset, whole) => {
  return match.toUpperCase() + `(${offset})`;
});
console.log(result); // "APPLE(0), banana, APPLE(18)"

範例 5:網頁互動替換

<!DOCTYPE html>
<html>
<body>
  <p id="demo">Visit Microsoft!</p>
  <button onclick="replaceText()">替換</button>
  <script>
    function replaceText() {
      const el = document.getElementById('demo');
      el.innerHTML = el.innerHTML.replaceAll('Microsoft', 'jb51.net');
    }
  </script>
</body>
</html>

特殊替換模式 (僅 replace/replaceAll 字串參數)

模式意義
$$插入 "$"
$&插入匹配的子字串
$`插入匹配前的字串
$'插入匹配後的字串
$n第 n 個捕獲群組 (正則時)
$<Name>具名捕獲群組 (ES2018)

範例:交換單詞順序

'John Smith'.replace(/(\w+)\s(\w+)/, '$2, $1'); // "Smith, John"

常見陷阱

  • 忘記正則全域旗標:str.replace(/abc/, 'x') 只替第一個。
  • replaceAll 字串參數特殊字元:字串參數會被視為字面值,不需轉義;正則參數需轉義元字元。
  • 原字串未改變:兩者都回傳新字串,需重新指派 str = str.replaceAll(...)。

相容性與 Polyfill

replaceAll 為 ES2021 標準,舊環境可用 Polyfill:

if (!String.prototype.replaceAll) {
  String.prototype.replaceAll = function(search, replace) {
    if (search instanceof RegExp) {
      if (!search.global) throw new TypeError('replaceAll requires global RegExp');
      return this.replace(search, replace);
    }
    return this.replace(new RegExp(search.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'g'), replace);
  };
}

總結

現代開發請優先使用 replaceAll() 進行全域字串替換,語意明確且不需正則轉義。需複雜模式匹配時搭配正則 replace(/pattern/g, ...)。永遠記得:字串不可變,回傳值才是結果。

copyright © 萬盛學電腦網 all rights reserved