JavaScript String replaceAll()
Examples
text = text.replaceAll("Cats","Dogs");
text = text.replaceAll("cats","dogs");
Try it Yourself »
text = text.replaceAll("cats","dogs");
text = text.replaceAll(/Cats/g,"Dogs");
text = text.replaceAll(/cats/g,"dogs");
Try it Yourself »
text = text.replaceAll(/cats/g,"dogs");
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.
The value, or regular expression, to search for.
newValue
Required.
The new value (to replace with).
This parameter can be a JavaScript function.
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 »
let result = text.replaceAll(/blue/gi, "red");
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 »
let result = text.replaceAll(/blue|house|car/gi, function (x) {
return x.toUpperCase();
});