.replace()

Published Jun 23, 2021Updated Jun 19, 2023
Contribute to Docs

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.

Example

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!

Codebyte Example

The following is runnable and demonstrates the .replace() method using regular expressions (RegExp):

us
Visit us
code
Hide code
Code
Output
Hide output
Hide output
Loading...

All contributors

Looking to contribute?

Learn JavaScript on Codecademy