文字列.replace() / replaceAll()

// 最初に一致した部分だけを置換します。
文字列.replace("検索文字列", "置換文字列")
文字列.replace(/正規表現/, "置換文字列")

// 一致したすべての部分を置換します。
文字列.replaceAll("検索文字列", "置換文字列")

var str = "item_a is a pending item. pending items require review.";

// replace は最初の1つだけを置換します。
console.log(str.replace("pending", "active"));

// replaceAll はすべてを置換します。
console.log(str.replaceAll("pending", "active"));

// 正規表現でgフラグを付けても全箇所を置換できます。
console.log(str.replace(/pending/g, "active"));

// 正規表現で大文字・小文字を無視して置換します。
var label = "product product PRODUCT";
console.log(label.replace(/product/gi, "item"));

// 元の文字列は変更されません。
console.log(str); // 『item_a is a pending item. pending items require review.』のまま出力されます。

// テキスト整形: 電話番号のハイフンを除去します。
var phone = "090-1234-5678";
var normalized = phone.replaceAll("-", "");
console.log(normalized);

// テンプレート文字列の差し込み: プレースホルダーを実際の値に置き換えます。
var template = "ユーザー {name} のポイント残高は {score} です。";
var message = template.replace("{name}", "user1").replace("{score}", "500");
console.log(message);

item_a is a active item. pending items require review.
item_a is a active item. active items require review.
item_a is a active item. active items require review.
item item ITEM
item_a is a pending item. pending items require review.
09012345678
ユーザー user1 のポイント残高は 500 です。

『文字列.replace()』は最初に一致した部分だけを置換するメソッドです。文字列を渡した場合、最初の1箇所しか置換されない点に注意してください。すべての一致箇所を置換したい場合は『文字列.replaceAll()』を使うか、正規表現にgフラグを付けて『文字列.replace()』に渡します。

『文字列.replaceAll()』はES2021で追加された比較的新しいメソッドで、すべての一致箇所を一度に置換できます。正規表現のgフラグを使う方法と結果は同じですが、正規表現に慣れていない場合は『文字列.replaceAll()』の方が読みやすいでしょう。

いずれのメソッドも元の文字列は変更せず、置換後の新しい文字列を返します。結果を使うためには、変数に代入するか直接利用する必要があります。