JavaScript String replace() Method

JavaScript String Reference JavaScript String Reference

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.

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

JavaScript String Reference JavaScript String Reference

SHARE THIS PAGE

COLOR PICKER

colorpicker