Latest web development tutorials
 

JavaScript String replace() Method

< JavaScript String Reference

Example

Return a string where "Microsoft" is replaced with "w3ii":

var str = "Visit Microsoft!";
var res = str.replace("Microsoft", "w3ii");

The result of res will be:

Visit w3ii!
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

Examples

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