JavaScript String replace()

Replace Microsoft:

let text = "Visit Microsoft!";
let result = text.replace("Microsoft", "W3Schools");

A global replacement:

let text = "Mr Blue has a blue house and a blue car";
let result = text.replace(/blue/g, "red");

More examples below.

Description

The replace() method searches a string for a value or a regular expression.

The replace() method returns a new string with the value(s) replaced.

The replace() method does not change the original string.

If you replace a value, only the first instance will be replaced. To replace all instances, use a regular expression with the g modifier set.

Read more about regular expressions in our:

string.replace(searchValue, newValue)

Parameter	Description
searchValue	Required. The value, or regular expression, to search for.
newValue	Required. The new value (to replace with).

Type	Description
A string	A new string where the specified value(s) has been replaced.

A global, case-insensitive replacement:

let text = "Mr Blue has a blue house and a blue car";
let result = text.replace(/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.replace(/blue|house|car/gi, function (x) {
return x.toUpperCase();
});

replace() is an ECMAScript1 (ES1) feature.

ES1 (JavaScript 1997) is fully supported in all browsers:


Chrome	Edge	Firefox	Safari	Opera	IE
Yes	Yes	Yes	Yes	Yes	Yes