→
その String 内を指定の正規表現または文字列に一致する全ての文字列を指定文字列で置換した文字列を返します。
| String | String。 | ||||||
|---|---|---|---|---|---|---|---|
regexp
| グローバルフラグを持つ RegExp オブジェクトまたはリテラルです。
| マッチしたものは newSubstr または、指定された function によって返された値に置き換えられます。グローバル("g")フラグのない RegExp は TypeError を投げます："replaceAll must be called with a global RegExp"。 substr
| newSubstr で置き換えられる String です。これは文字列リテラルとして扱われ、正規表現として解釈されません。
| newSubstr
| regexp または substr で指定された部分文字列を置き換える String です。
| いくつかの特殊な置換パターンがサポートされています。下記の「引数としての文字列の指定」セクションで説明しています。 function
| 指定された regexp または substr のマッチを置き換えるために使用される、新しい部分文字列を生成するために呼び出される関数です。
| この関数に与えられる引数については、下記の「引数としての関数の指定」セクションで説明しています。 |
String。パターンにマッチしたすべての文字列を置換文字列で置き換えた新しい文字列です。
このメソッドは、呼び出し元の String オブジェクトを変更しません。戻り値として新しい文字列を返します。
置換文字列には以下の特殊な置換パターンを含めることができます：
| パターン | 挿入 |
|---|---|
$$
| "$" を挿入します。 |
$&
| マッチした部分文字列を挿入します。 |
$`
| マッチした部分文字列の直前の文字列の部分を挿入します。 |
$'
| マッチした部分文字列の直後の文字列の部分を挿入します。 |
$n
| n は 100 未満の正の整数です。第一引数が RegExp オブジェクトだった場合に n 番目の括弧でキャプチャされた文字列を挿入します。1、2、... でインデックスされることに注意してください。 |
第二引数として関数を指定することができます。このとき、関数はマッチが完了した後に実行されます。関数呼び出しの結果（返り値）は、置換文字列として使われます（注： 上記の特殊な置換パターンはこの場合には適用されません）。
第一引数の正規表現がグローバルだと、置換されるべきマッチごとに関数が複数回実行されうることに注意してください。
関数に与えられる引数は次の通りです：
| 引数名 | 与えられる値 |
|---|---|
| match | マッチした部分文字列（上記の $& に対応）です。 |
| p1, p2, ... | replace() の第一引数が RegExp オブジェクトだった場合、n 番目の括弧でキャプチャされたグループの文字列（上記の $1、$2、などに対応）です。
例えば /(\a+)(\b+)/ が与えられた場合、p1 は \a+ に対するマッチ、p2 は \b+ に対するマッチとなります。 |
| offset | マッチした部分文字列の、分析中の文字列全体の中でのオフセットです（例えば、文字列全体が 'abcd' で、マッチした部分文字列が 'bc' ならば、この引数は 1 となります）。 |
| string | 分析中の文字列全体です。 |
（引数の正確な個数は、第一引数が RegExp オブジェクトかどうか、そうならばさらに括弧でキャプチャされるサブ･マッチがいくつ指定されているかに依ります。）
D='aabbcc'.replaceAll('b', '.'); //＝"aa..cc"
正規表現フラグを使用する場合は、グローバルである必要があります。これは機能しません：
D='aabbcc'.replaceAll(/b/, '.'); // TypeError: replaceAll must be called with a global RegExp
これは機能します：
D='aabbcc'.replaceAll(/b/g, '.'); //＝"aa..cc"