gulp-replace-string
Replaces strings in files by using string or regex patterns.
You'll actually want to instead use @yodasws/gulp-pattern-replace (npm). It provides extra flexability and smaller dependency tree.
Forked this off gulp-string-replace because I wanted to be able to pass all the arguments/options in a single options object argument.
Installation
yarn
yarn add --dev gulp-replace-string
npm
npm install --save-dev gulp-replace-string
Usage
Regex Replace
var replace = ; gulp; gulp; gulp;
String Replace
gulp;
Function Replace
gulp; gulp;
Example with options object
var options = pattern: /@env@/g replacement: 'dev' logs: enabled: false ; gulp
An Array
gulp
API
replace(options)
options
Type: Object
options.pattern
Type: String
or RegExp
The string to search for.
options.replacement
Type: String
or Function
The replacement string or function. Called once for each match. Function has access to regex outcome (all arguments are passed).
More details here: [MDN documentation for RegExp] and [MDN documentation for String.replace].
options.logs
Type: Boolean
or Object
Output logs.
true
is the same as:
logs: enabled: true notReplaced: false
options.logs.enabled
Type: Boolean
, Default: true
Output logs.
options.logs.notReplaced
Type: Boolean
, Default: false
Output "not replaced" logs.
replace(pattern, replacement, options)
pattern
Type: String
or RegExp
The string to search for.
replacement
Type: String
or Function
The replacement string or function. Called once for each match. Function has access to regex outcome (all arguments are passed).
options
Type: Object
Same as above, but without properties pattern
or replacement