JavaScript String replace() Method
Example
Return a string where "Microsoft" is replaced with "W3Schools":
var str = "Visit Microsoft!";
var res = str.replace("Microsoft", "W3Schools");
Try it Yourself »
More "Try it Yourself" examples below.
Definition and Usage
The replace() method searches a string for a specified value, or a regular expression, and returns a new string where the specified values are replaced.
Note: If you are replacing a value (and not a regular expression), only the first instance of the value will be replaced. To replace all occurrences of a specified value, use the global (g) modifier (see "More Examples" below).
Read more about regular expressions in our RegExp Tutorial and our RegExp Object Reference.
This method does not change the original string.
Browser Support
Method | |||||
---|---|---|---|---|---|
replace() | Yes | Yes | Yes | Yes | Yes |
Syntax
string.replace(searchvalue, newvalue)
Parameter Values
Parameter | Description |
---|---|
searchvalue | Required. The value, or regular expression, that will be replaced by the new value |
newvalue | Required. The value to replace the search value with |
Technical Details
Return Value: | A new String, where the specified value(s) has been replaced by the new value |
---|---|
JavaScript Version: | ECMAScript 1 |
More Examples
Example
Perform a global replacement:
var str = "Mr Blue has a blue house and a blue car";
var res = str.replace(/blue/g, "red");
Try it Yourself »
Example
Perform a global, case-insensitive replacement:
var str = "Mr Blue has a blue house and a blue car";
var res = str.replace(/blue/gi, "red");
Try it Yourself »
Example
Using a function to return the replacement text:
var str = "Mr Blue has a blue house and a blue car";
var res = str.replace(/blue|house|car/gi, function (x) {
return x.toUpperCase();
});
Try it Yourself »