replace-string

Replace all substring matches in a string

Similar to String#replace(), but supports replacing multiple matches. You could achieve something similar by putting the string in a RegExp constructor with the global flag and passing it to String#replace(), but you would then have to first escape the string anyways.

Install

$ npm install replace-string

Usage

const replaceString = require('replace-string');

const string = 'My friend has a 🐑. I want a 🐑 too!';

replaceString(string, '🐑', '🦄');
//=> 'My friend has a 🦄. I want a 🦄 too!'

API

replaceString(string, needle, replacement, [options])

Returns a new string with all needle matches replaced with replacement.

string

Type: string

String to work on.

needle

Type: string

String to match in input.

replacement

Type: string | Function

Replacement for needle matches.

If a function, it receives the following arguments; the needle, the match count, and the input:

replaceString('Foo 🐑 Bar', '🐑', (needle, matchCount, input, matchIndex) => `${needle}❤️`);
//=> 'Foo 🐑❤️ Bar'

options

Type: object

fromIndex

Type: number
Default: 0

Index at which to start replacing.

execall - Find multiple RegExp matches in a string

perrinennen/replace-string