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.

The replaceAll() method does not work in Internet Explorer.

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 stringA 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 »

Copyright 1999-2023 by Refsnes Data. All Rights Reserved.