JavaScript String replaceAll()

定義と使用方法

replaceAll() このメソッドは文字列内で指定された値または正規表現を検索します。

replaceAll() このメソッドはすべての一致する値を置き換えた新しい文字列を返します。

replaceAll() このメソッドは元の文字列を変更しません。

replaceAll() このメソッドはJavaScript 2021で導入されました。

replaceAll() このメソッドはInternet Explorerで使用できません。

注意

引数が正規表現である場合、グローバルフラグを設定する必要があります(g),さもなければTypeErrorが投げられます。

正規表現に関する詳細については、以下を参照してください:

正規表現チュートリアル

正規表現リファレンス

例 1

text = text.replaceAll("Cats","Dogs");
text = text.replaceAll("cats","dogs");

自分で試してみてください

例 2

text = text.replaceAll(/Cats/g,"Dogs");
text = text.replaceAll(/cats/g,"dogs");

自分で試してみてください

例 2

グローバル、大小を区別しない置き換え:

let text = "Mr Blue has a blue house and a blue car";
let result = text.replaceAll(/blue/gi, "red");

自分で試してみてください

例 3

関数を使用して置き換えテキストを返します:

let text = "Mr Blue has a blue house and a blue car";
let result = text.replaceAll(/blue|house|car/gi, function (x) {
  return x.toUpperCase();
});

自分で試してみてください

構文

string.replaceAll(searchValue, newValue)

引数

引数 説明
searchValue 必要です。検索する値または正規表現です。
newValue 必要です。置き換える新しい値です。JavaScript関数でできます。

戻り値

タイプ 説明
String すべての一致する値が置き換わった新しい文字列を返します。