README.md

gulp-autopolyfiller

Autopolyfiller - Precise polyfills. Automatic and minimal polyfills for your code.

Usage

First, install gulp-autopolyfiller as a development dependency:

npm install --save-dev gulp-autopolyfiller

Then, add it to your gulpfile.js:

var autopolyfiller = require('gulp-autopolyfiller');

gulp.task('autopolyfiller', function () {
    return gulp.src('./lib/**/*.js')
        .pipe(autopolyfiller('result_polyfill_file.js'))
        .pipe(gulp.dest('./dist'));
});

API

autopolyfiller(fileName, options)

options.browsers

Type: Array Default value: [] - all browsers

options.include

Type: Array Default value: [] - list of extra polyfills to add

options.exclude

Type: Array Default value: [] - list of polyfills to remove

List of target browsers. Autopolyfiller uses Autoprefixer-style browsers format. See Browsers format for details.

Examples

Browsers targets

You can specify list of target browsers to reduce amount of polyfills.

var autopolyfiller = require('gulp-autopolyfiller');

gulp.src('./your/js/**/*.js')
	.pipe(autopolyfiller('result_polyfill_file.js', {
        browsers: ['last 2 version', 'ie 8', 'ie 9']
    }))
	.pipe(gulp.dest('./dist'));

Default browsers of Autoprefixer

var autopolyfiller = require('gulp-autopolyfiller');

gulp.src('./your/js/**/*.js')
	.pipe(autopolyfiller('result_polyfill_file.js', {
		browsers: require('autoprefixer').default
	}))
	.pipe(gulp.dest('./dist'));

Removig polyfills

var autopolyfiller = require('gulp-autopolyfiller');

gulp.src('./your/js/**/*.js')
	.pipe(autopolyfiller('polyfills_without_promises.js', {
		exclude: ['Promise']
	}))
	.pipe(gulp.dest('./dist'));

License

MIT License