JavaScript String replaceAll()
Examples
text = text.replaceAll("Cats","Dogs");
text = text.replaceAll("cats","dogs");
Try it Yourself »
text = text.replaceAll(/Cats/g,"Dogs");
text = text.replaceAll(/cats/g,"dogs");
Try it Yourself »
More example below.
Description
The replaceAll() method searches a string for a value or a regular expression.
The replaceAll() method returns a new string with all values replaced.
The replaceAll() method does not change the original string.
The replaceAll() method was introduced in JavaScript 2021.
Note
If the parameter is a regular expression, the global flag (g) must be set, otherwise a TypeError is thrown.
Read more about regular expressions in our:
Syntax
string.replaceAll(searchValue, newValue)
Parameters
| Parameter | Description |
| searchValue | Required. The value, or regular expression, to search for. |
| newValue | Required. The new value (to replace with). This parameter can be a JavaScript function. |
Return Value
| Type | Description |
| A string | A new string where the search values has been replaced. |
More Examples
A global, case-insensitive replacement:
let text = "Mr Blue has a blue house and a blue car";
let result = text.replaceAll(/blue/gi, "red");
Try it Yourself »
A function to return the replacement text:
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();
});
Try it Yourself »
