gulp-renew

[ English | 中文 ]

支持字符串批量替换插件。
替换规则支持正则表达式和函数替换。

Based on gulp-replace

Installation

npm install --save-dev gulp-renew

Usage

1const gulp = require('gulp');
2const renew = require('gulp-renew');
3
4gulp.task('default', function() {
5  return gulp.src('src/**/*.js')
6   .pipe(renew([
7      { search: 'oldText', replacement: 'newText' },
8      { search: /oldPattern/g, replacement: 'newPattern' }
9    ]))
10   .pipe(gulp.dest('dist'));
11});
12
13gulp.task('html', function() {
14  return gulp.src('src/**/*.html')
15   .pipe(renew([
16      [‘foo1’, 'bar1'],
17      [/foo2/g, 'bar2'],
18      [‘foo3’, 'bar3']
19    ]))
20   .pipe(gulp.dest('dist'));
21});

API

1renew(replacements[, options])

replacements

包含要进行替换的规则。每个规则是一个对象，包含 search 和 replacement 属性

type: Array<{ search: string | RegExp, replacement: string | Function }>

• search：要搜索的字符串或正则表达式。
• replacement：要替换的字符串或函数。

options

选项

Type: Object

options.skipBinary

是否跳过二进制文件。

Type: boolean

Default: true

如果 skipBinary 选项设置为 true，插件将不会处理二进制文件。

示例：

• 字符串替换：

1# 写法 1：
2renew([
3  { search: 'foo', replacement: 'bar' }
4])
5
6# 写法 2：
7renew([
8  ['foo', 'bar']
9])
10
11# 写法 3 ：
12renew({ 'foo1': 'bar1', 'foo2': 'bar2' })

• 正则表达式替换

1renew({ search: /oldPattern/g, replacement: 'newPattern' })

• 函数替换

1renew([
2  {
3    search: 'oldText',
4    replacement: function (match) {
5      return match.toUpperCase()
6    },
7  },
8  {
9    search: /foo(.{3})/g,
10    replacement: function (match, p1, offset, string) {
11      return 'bar' + p1
12    },
13  },
14])