gulp-filter

Filter files in a vinyl stream

Enables you to work on a subset of the original files by filtering them using glob patterns. When you're done and want all the original files back, you just use the restore stream.

Install

1npm install --save-dev gulp-filter

Usage

Filter only

You may want to just filter the stream content:

1import gulp from 'gulp';
2import uglify from 'gulp-uglify';
3import filter from 'gulp-filter';
4
5export default () => {
6	// Create filter instance inside task function
7	const f = filter(['**', '!*src/vendor']);
8
9	return gulp.src('src/**/*.js')
10		// Filter a subset of the files
11		.pipe(f)
12		// Run them through a plugin
13		.pipe(uglify())
14		.pipe(gulp.dest('dist'));
15};

Restoring filtered files

1import gulp 'gulp';
2import uglify 'gulp-uglify';
3import filter 'gulp-filter';
4
5export default () => {
6	// Create filter instance inside task function
7	const f = filter(['**', '!*src/vendor'], {restore: true});
8
9	return gulp.src('src/**/*.js')
10		// Filter a subset of the files
11		.pipe(f)
12		// Run them through a plugin
13		.pipe(uglify())
14		// Bring back the previously filtered out files (optional)
15		.pipe(f.restore)
16		.pipe(gulp.dest('dist'));
17};

Multiple filters

By combining and restoring different filters you can process different sets of files with a single pipeline.

1import gulp from 'gulp';
2import less from 'gulp-less';
3import concat from 'gulp-concat';
4import filter from 'gulp-filter';
5
6export default () => {
7	const jsFilter = filter('**/*.js', {restore: true});
8	const lessFilter = filter('**/*.less', {restore: true});
9
10	return gulp.src('assets/**')
11		.pipe(jsFilter)
12		.pipe(concat('bundle.js'))
13		.pipe(jsFilter.restore)
14		.pipe(lessFilter)
15		.pipe(less())
16		.pipe(lessFilter.restore)
17		.pipe(gulp.dest('out/'));
18};

Restore as a file source

You can restore filtered files in a different place and use it as a standalone source of files (ReadableStream). Setting the passthrough option to false allows you to do so.

1import gulp 'gulp';
2import uglify 'gulp-uglify';
3import filter 'gulp-filter';
4
5export default () => {
6	const f = filter(['**', '!*src/vendor'], {restore: true, passthrough: false});
7
8	const stream = gulp.src('src/**/*.js')
9		// Filter a subset of the files
10		.pipe(f)
11		// Run them through a plugin
12		.pipe(uglify())
13		.pipe(gulp.dest('dist'));
14
15	// Use filtered files as a gulp file source
16	f.restore.pipe(gulp.dest('vendor-dist'));
17
18	return stream;
19};

API

filter(pattern, options?)

Returns a transform stream with a .restore property.

pattern

Type: string | string[] | Function

Accepts a string/array with globbing patterns which are run through multimatch.

If you supply a function, you'll get a vinyl file object as the first argument and you're expected to return a boolean of whether to include the file:

1filter(file => /unicorns/.test(file.path));

options

Type: object

Accepts minimatch options.

Note: Set dot: true if you need to match files prefixed with a dot, for example, .gitignore.

restore

Type: boolean
Default: false

Restore filtered files.

passthrough

Type: boolean
Default: true

When set to true, filtered files are restored with a stream.PassThrough, otherwise, when set to false, filtered files are restored as a stram.Readable.

When the stream is a stream.Readable, it ends by itself, but when it's stream.PassThrough, you are responsible of ending the stream.