JavaScript String replace() Method

## JavaScript Reference

Overview

## JavaScript Objects

JS Array JS Boolean JS Date JS Math JS Number JS String JS RegExp JS Global

## Browser Objects

Window Navigator Screen History Location

## HTML DOM Objects

DOM Document DOM Elements DOM Attributes DOM Events

## HTML Objects

DOM Anchor DOM Area DOM Base DOM Body DOM Button DOM Form DOM Frame/IFrame DOM Frameset DOM Image DOM Input Button DOM Input Checkbox DOM Input File DOM Input Hidden DOM Input Password DOM Input Radio DOM Input Reset DOM Input Submit DOM Input Text DOM Link DOM Meta DOM Object DOM Option DOM Select DOM Style DOM Table DOM td / th DOM tr DOM Textarea

# JavaScript String replace() Method

JavaScript String Object

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

## 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

The replace() method is supported in all major browsers.

## 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

## Return Value

Type | Description
--- | ---
String | A new string where the specified value(s) has been replaced by the new value

## Technical Details

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 »

JavaScript String Object

## Your suggestion:

Your E-mail (optional):

Page address:

Description:

Close [X]

## Thank You For Helping Us!

Your message has been sent to W3Schools.

Close [X]
Search w3schools.com:

## WEB HOSTING

Best Web Hosting UK Reseller Hosting Wow! $5 SSD Hosting

## WEB BUILDING

Download XML Editor
FREE Website BUILDER FREE Website Creator

## WEB RESOURCES

Web Statistics Web Validation

## SHARE THIS PAGE