JavaScript String replace() Method
Example
Return a string where "Microsoft" is replaced with "W3Schools":
var str = "Visit Microsoft!";
var res = str.replace("Microsoft", "W3Schools");
The result of res will be:
Visit 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: | 1.2 |
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");
The result of res will be:
Mr Blue has a red house and a red car
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");
The result of res will be:
Mr red has a red house and a red car
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 myFunction(x){return x.toUpperCase();});
The result of res will be:
Mr BLUE has a BLUE HOUSE and a BLUE CAR.
Try it Yourself »
JavaScript String Reference
