.replace()

Searches a string for a string value, or a regular expression, and returns a new string where some or all matches are replaced.

Syntax

string.replace(searchValue, replacementValue);

If the searchValue is a string then only the first instance of the value will be replaced. To replace all instances, use the global (g) modifier on a regular expression.

Examples

Replace 'cats' with 'rats':

const weather = `It's raining cats and dogs!`;
const replaceCatsWithRats = weather.replace('cats', 'rats');
console.log(replaceCatsWithRats);
// Output: It's raining rats and dogs!

Find and replace multiple matches:

const kidsBook = 'Brown bear, brown bear, what do you see?';
const birdsNotBears = kidsBook.replace(/bear/g, 'bird');
console.log(birdsNotBears);
// Output: Brown bird, brown bird, what do you see?

Contributors

Interested in helping build Docs? Read the Contribution Guide or share your thoughts in this feedback form.

Learn JavaScript on Codecademy

Contributors