gulp-string-replace

Replaces strings in files by using string or regex patterns. Works with Gulp 3!

Usage

1npm install gulp-string-replace --save-dev

Regex Replace

1var replace = require('gulp-string-replace');
2
3gulp.task('replace_1', function() {
4  gulp.src(["./config.js"]) // Any file globs are supported
5    .pipe(replace(new RegExp('@env@', 'g'), 'production'))
6    .pipe(gulp.dest('./build/config.js'))
7});
8
9gulp.task('replace_2', function() {
10  gulp.src(["./index.html"])
11    .pipe(replace(/version(={1})/g, '$1v0.2.2'))
12    .pipe(gulp.dest('./build/index.html'))
13});
14
15gulp.task('replace_3', function() {
16  gulp.src(["./config.js"])
17    .pipe(replace(/foo/g, function () {
18        return 'bar';
19    }))
20    .pipe(gulp.dest('./build/config.js'))
21});

String Replace

1gulp.task('replace_1', function() {
2  gulp.src(["./config.js"])
3    .pipe(replace('environment', 'production'))
4    .pipe(gulp.dest('./build/config.js'))
5});

Function Replace

1gulp.task('replace_1', function() {
2  gulp.src(["./config.js"])
3    .pipe(replace('environment', function () {
4        return 'production';
5    }))
6    .pipe(gulp.dest('./build/config.js'))
7});
8
9gulp.task('replace_2', function() {
10  gulp.src(["./config.js"])
11    .pipe(replace('environment', function (replacement) {
12        return replacement + '_mocked';
13    }))
14    .pipe(gulp.dest('./build/config.js'))
15});
16

Exampe with options object

1
2var options = {
3  logs: {
4    enabled: false
5  }
6};
7
8gulp.task('replace_1', function() {
9  gulp.src(["./config.js"])
10    .pipe(replace('environment', 'dev', options)
11    .pipe(gulp.dest('./build/config.js'))
12});
13

1
2var options = {
3  searchValue: 'string'
4};
5
6gulp.task('replace_1', function() {
7  gulp.src(["./config.js"])
8    .pipe(replace('(some value here /* ignore by sth */)(', 'dev', options)
9    .pipe(gulp.dest('./build/config.js'))
10});
11

API

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

options.searchValue

Type: string, Default: regex, Options: regex or string Description: Used to determine if search value is regex or string.

options.logs.enabled

Type: Boolean, Default: true

Displaying logs.

options.logs.notReplaced

Type: Boolean, Default: false

Displaying "not replaced" logs.

More details here: MDN documentation for RegExp and MDN documentation for String.replace.

Release History

• 2018-10-12 v1.1.2 Fixed issue wrong stream parameters.
• 2018-07-13 v1.1.1 Moved gulp into devDependencies.
• 2018-05-24 v1.1.0 Added support for node 8+ by replacing buffer with buffer.from. Added searchValue option. Updated dependencies.
• 2017-12-31 v1.0.0 Removed a gulp-util, clean up and released v1.0.0
• 2017-11-19 v0.4.0 Passed entire regex outcome to replace function.
• 2017-01-04 v0.3.1 Improved documentation. Removed duplicated comments & Fixed typo.
• 2016-11-30 v0.3.0 Default value for "notReplaced" set to "false".
• 2016-09-24 v0.2.0 Added options object.
• 2016-09-09 v0.1.1 Reorganization of files along with minor cosmetic changes.
• 2016-03-09 v0.1.0 Initial version of plugin.

Task submitted by Tomasz Czechowski. License MIT.