String.prototype.replaceAll()

const newStr = str.replaceAll(regexp|substr, newSubstr|function)

regexp (pattern)

グローバルフラグを持つ RegExp オブジェクトまたはリテラルです。マッチしたものは newSubstr または、指定された function によって返された値に置き換えられます。グローバル("g")フラグのない RegExp は TypeError を投げます："replaceAll must be called with a global RegExp".

substr

newSubstr で置き換えられる String です。これは文字列リテラルとして扱われ、正規表現として解釈されません。

newSubstr (replacement)

regexp または substr で指定された部分文字列を置き換える String です。いくつかの特殊な置換パターンがサポートされています。下記の「引数としての文字列の指定」セクションで説明しています。

function (replacement)

指定された regexp または substr のマッチを置き換えるために使用される、新しい部分文字列を生成するために呼び出される関数です。この関数に与えられる引数については、下記の「引数としての関数の指定」セクションで説明しています。

パターンにマッチしたすべての文字列を置換文字列で置き換えた新しい文字列です。

このメソッドは、呼び出し元の String オブジェクトを変更しません。戻り値として新しい文字列を返します。

置換文字列には以下の特殊な置換パターンを含めることができます。

第二引数として関数を指定することができます。このとき、関数はマッチが完了した後に実行されます。関数呼び出しの結果（返り値）は、置換文字列として使われます（注: 上記の特殊な置換パターンはこの場合には適用されません）。

第一引数の正規表現がグローバルだと、置換されるべきマッチごとに関数が複数回実行されうることに注意してください。

関数に与えられる引数は次の通りです。

（引数の正確な個数は、第一引数が RegExp オブジェクトかどうか、そうならばさらに括弧でキャプチャされるサブマッチがいくつ指定されているかに依ります。）

正規表現フラグを使用する場合は、グローバルである必要があります。これは機能しません：

'aabbcc'.replaceAll(/b/, '.');
TypeError: replaceAll must be called with a global RegExp

これは機能します：

'aabbcc'.replaceAll(/b/g, '.');
"aa..cc"

• String.prototype.replace()
• String.prototype.match()
• RegExp.prototype.exec()
• RegExp.prototype.test()