microfill v0.1.0

Microfill

Only loads polyfills for the missing gabs.

How does it work

Microfill replaces your javascript file with a file that looks like this:

;(function(){
	var n = 0;

	if (!window.setImmediate) n += 1 << 0;
	if (!window.Promise) n += 1 << 1;
	if (!window.fetch) n += 1 << 2;
	if (!window.WeakMap || !window.Map || !window.Set) n += 1 << 3;

	var script = document.createElement("script");
	script.src = "file-" + n.toString(16) + ".js";
	script.type = "text/javascript";
	document.head.appendChild(script);
})();

If a feature is missing, n will be increased by a certain value. Based on the final value of n a file will be loaded. Microfill generates such file for every possible combination of polyfills that are needed. See the test directory for a sample output.

How to use

Using node.js

var microfill = require('microfill');

microfill.compile(
	'lib/script.js', // Input
	'dist/script.js', // Output
	'script.js', // Filename that will be used in the compiled file
	['set-immediate', 'promise', 'fetch', 'collections'] // Polyfills
);

Using gulp

Use gulp-microfill.

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

gulp.task('default', function() {
	gulp.src('lib/**/*.js')
		.pipe(microfill(['set-immediate', 'promise', 'fetch', 'collection']))
		.pipe(gulp.dest('release'))
});

Supported polyfills

• set-immediate
• promise
• fetch
• collections (WeapMap, Map, Set)

License

MIT