polyfill-library 3.106.0 → 3.110.0

package/test/unit/lib/index.js

@@ -1,414 +0,0 @@
-
-
-"use strict";
-
-const assert = require('proclaim');
-const mockery = require('mockery');
-const setsToArrays = require('../../utils/sets-to-arrays');
-
-describe("polyfillio", () => {
-	const packageMock = {};
-	let fs;
-	let path;
-	let toposort;
-	let UA;
-	let sourceslib;
-	let handlebars;
-	let streamFromPromise;
-	let from2String;
-	let merge2;
-	let streamToString;
-
-	beforeEach(() => {
-		fs = require('../mock/graceful-fs.mock');
-		mockery.registerMock('graceful-fs', fs);
-
-		path = require('../mock/path.mock');
-		mockery.registerMock('path', path);
-
-		toposort = require('../mock/toposort.mock');
-		mockery.registerMock('toposort', toposort);
-
-		UA = require('../mock/ua.mock');
-		mockery.registerMock('@financial-times/polyfill-useragent-normaliser', UA);
-
-		sourceslib = require('../mock/sources.mock');
-		mockery.registerMock('./sources', sourceslib);
-
-		mockery.registerMock('package', packageMock);
-
-		handlebars = require('../mock/handlebars.mock');
-		mockery.registerMock('handlebars', handlebars);
-
-		streamFromPromise = require('../mock/stream-from-promise.mock');
-		mockery.registerMock('stream-from-promise', streamFromPromise);
-
-		from2String = require('../mock/from2-string.mock');
-		mockery.registerMock('from2-string', from2String);
-
-		merge2 = require('../mock/merge2.mock');
-		mockery.registerMock('merge2', merge2);
-
-		streamToString = require('../mock/stream-to-string.mock');
-		mockery.registerMock('stream-to-string', streamToString);
-
-	});
-
-	describe('exported property/properties', () => {
-		it('is an object', () => {
-			assert.isObject(require('../../../lib'));
-		});
-
-		it('describePolyfill is an exported function', () => {
-			const polyfillio = require('../../../lib');
-			assert.isFunction(polyfillio.describePolyfill);
-		});
-
-		it('listAllPolyfills is an exported function', () => {
-			const polyfillio = require('../../../lib');
-			assert.isFunction(polyfillio.listAllPolyfills);
-		});
-
-		it('listAliases is an exported function', () => {
-			const polyfillio = require('../../../lib');
-			assert.isFunction(polyfillio.listAliases);
-		});
-
-		it('getPolyfills is an exported function', () => {
-			const polyfillio = require('../../../lib');
-			assert.isFunction(polyfillio.getPolyfills);
-		});
-
-		it('getPolyfillString is an exported function', () => {
-			const polyfillio = require('../../../lib');
-			assert.isFunction(polyfillio.getPolyfillString);
-		});
-
-		it('normalizeUserAgent is an exported function', () => {
-			const polyfillio = require('../../../lib');
-			assert.isFunction(polyfillio.normalizeUserAgent);
-		});
-	});
-
-	describe('.listAllPolyfills()', () => {
-		it('calls and returns sourceslib.listPolyfills() without passing argument', () => {
-			const polyfillio = require('../../../lib');
-			sourceslib.listPolyfills.resolves('return value for sourceslib.listPolyfills');
-			return polyfillio.listAllPolyfills('test').then(result => {
-				assert.equal(result, 'return value for sourceslib.listPolyfills');
-				assert.calledOnce(sourceslib.listPolyfills);
-				assert.neverCalledWith(sourceslib.listPolyfills, 'test');
-			});
-		});
-	});
-
-	describe('.describePolyfill()', () => {
-		it('calls and returns sourceslib.getPolyfillMeta() with passed argument', () => {
-			const polyfillio = require('../../../lib');
-
-			sourceslib.getPolyfillMeta.resolves('return value for sourceslib.getPolyfillMeta');
-			return polyfillio.describePolyfill('test')
-				.then(result => {
-					assert.equal(result, 'return value for sourceslib.getPolyfillMeta');
-					assert.calledOnce(sourceslib.getPolyfillMeta);
-					assert.calledWithExactly(sourceslib.getPolyfillMeta, 'test');
-				});
-		});
-	});
-
-	describe('.normalizeUserAgent()', () => {
-		it('calls and returns UA.normalize() with passed argument and UA', () => {
-			const polyfillio = require('../../../lib');
-			UA.normalize.returns('return value for UA.normalize');
-			assert.equal(polyfillio.normalizeUserAgent('test'), 'return value for UA.normalize');
-			assert.calledOnce(UA.normalize);
-			assert.calledWithExactly(UA.normalize, 'test');
-		});
-	});
-
-	describe('.getOptions(opts)', () => {
-		it('returns the default options if called without any arguments', () => {
-			const polyfillio = require('../../../lib');
-			assert.deepStrictEqual(polyfillio.getOptions(), {
-				callback: false,
-				uaString: '',
-				minify: true,
-				unknown: 'polyfill',
-				features: {},
-				excludes: [],
-				rum: false
-			});
-		});
-
-		it('does not assign a default value if the property exists in the argument', () => {
-			const polyfillio = require('../../../lib');
-			assert.deepStrictEqual(polyfillio.getOptions({}), {
-				callback: false,
-				uaString: '',
-				minify: true,
-				unknown: 'polyfill',
-				features: {},
-				excludes: [],
-				rum: false
-			});
-			assert.deepStrictEqual(polyfillio.getOptions({
-				callback: 'app'
-			}), {
-				callback: 'app',
-				uaString: '',
-				minify: true,
-				unknown: 'polyfill',
-				features: {},
-				excludes: [],
-				rum: false
-			});
-			assert.deepStrictEqual(polyfillio.getOptions({
-				callback: ''
-			}), {
-				callback: false,
-				uaString: '',
-				minify: true,
-				unknown: 'polyfill',
-				features: {},
-				excludes: [],
-				rum: false
-			});
-			assert.deepStrictEqual(polyfillio.getOptions({
-				callback: 'hello world'
-			}), {
-				callback: false,
-				uaString: '',
-				minify: true,
-				unknown: 'polyfill',
-				features: {},
-				excludes: [],
-				rum: false
-			});
-			assert.deepStrictEqual(polyfillio.getOptions({
-				uaString: 'example'
-			}), {
-				callback: false,
-				uaString: 'example',
-				minify: true,
-				unknown: 'polyfill',
-				features: {},
-				excludes: [],
-				rum: false
-			});
-			assert.deepStrictEqual(polyfillio.getOptions({
-				minify: false
-			}), {
-				callback: false,
-				uaString: '',
-				minify: false,
-				unknown: 'polyfill',
-				features: {},
-				excludes: [],
-				rum: false
-			});
-			assert.deepStrictEqual(polyfillio.getOptions({
-				unknown: 'ignore'
-			}), {
-				callback: false,
-				uaString: '',
-				minify: true,
-				unknown: 'ignore',
-				features: {},
-				excludes: [],
-				rum: false
-			});
-			assert.deepStrictEqual(polyfillio.getOptions({
-				features: {
-					'Array.of': {}
-				}
-			}), {
-				callback: false,
-				uaString: '',
-				minify: true,
-				unknown: 'polyfill',
-				features: {
-					'Array.of': {
-						flags: new Set
-					}
-				},
-				excludes: [],
-				rum: false
-			});
-			assert.deepStrictEqual(polyfillio.getOptions({
-				excludes: ['Array.of']
-			}), {
-				callback: false,
-				uaString: '',
-				minify: true,
-				unknown: 'polyfill',
-				features: {},
-				excludes: ['Array.of'],
-				rum: false
-			});
-			assert.deepStrictEqual(polyfillio.getOptions({
-				rum: true
-			}), {
-				callback: false,
-				uaString: '',
-				minify: true,
-				unknown: 'polyfill',
-				features: {},
-				excludes: [],
-				rum: true
-			});
-		});
-
-		it('converts feature flag Arrays into Sets', () => {
-			const polyfillio = require('../../../lib');
-			assert.deepStrictEqual(polyfillio.getOptions({
-				features: {
-					'Array.from': {
-						flags: ['a', 'b', 'c']
-					}
-				}
-			}), {
-				callback: false,
-				uaString: '',
-				minify: true,
-				unknown: 'polyfill',
-				features: {
-					'Array.from': {
-						flags: new Set(['a', 'b', 'c'])
-					}
-				},
-				excludes: [],
-				rum: false
-			});
-		});
-	});
-
-	describe('.getPolyfills()', () => {
-
-		describe('when options.uaString is not set', () => {
-			it('calls UA with options.uAString set to an empty string', () => {
-				const polyfillio = require('../../../lib');
-				const options = {};
-				return polyfillio.getPolyfills(options).then(() => {
-					assert.calledWithExactly(UA, '');
-				});
-			});
-		});
-
-		describe('when options.uaString is set', () => {
-			it('calls UA with options.uAString', () => {
-				const polyfillio = require('../../../lib');
-				const options = {
-					uaString: 'chrome/38'
-				};
-				return polyfillio.getPolyfills(options).then(() => {
-					assert.calledWithExactly(UA, 'chrome/38');
-				});
-			});
-		});
-
-		it("should remove features not appropriate for the current UA", () => {
-			sourceslib.getPolyfillMeta.resolves({
-				"browsers": {
-					"ie": "6 - 8"
-				}
-			});
-			UA.mockUAInstance.getFamily.returns('ie');
-			UA.mockUAInstance.satisfies.returns(false);
-
-			const polyfillio = require('../../../lib');
-
-			const options = {
-				features: {
-					'Array.prototype.map': {}
-				},
-				uaString: 'ie/9'
-			};
-
-			return polyfillio.getPolyfills(options).then(result => {
-				assert.deepEqual(setsToArrays(result), {});
-			});
-		});
-
-		it("should respect the always flag", () => {
-			sourceslib.getPolyfillMeta.resolves({
-				"browsers": {
-					"ie": "6 - 8"
-				}
-			});
-			UA.mockUAInstance.getFamily.returns('ie');
-			UA.mockUAInstance.satisfies.returns(false);
-
-			const polyfillio = require('../../../lib');
-
-			const input = {
-				features: {
-					'Array.prototype.map': {
-						flags: new Set(['always'])
-					}
-				},
-				uaString: 'ie/9'
-			};
-			const expectedResult = {
-				'Array.prototype.map': {
-					flags: ['always'],
-					aliasOf: [],
-					dependencyOf: []
-				}
-			};
-			return polyfillio.getPolyfills(input).then(result => {
-				assert.deepEqual(setsToArrays(result), expectedResult);
-			});
-		});
-
-		it("should include dependencies", () => {
-			sourceslib.getPolyfillMeta.withArgs('Element.prototype.placeholder').resolves({
-				"dependencies": ["setImmediate", "Array.isArray", "Event"],
-				"browsers": {
-					"ie": "*"
-				}
-			});
-			sourceslib.getPolyfillMeta.withArgs('setImmediate').resolves({
-				"dependencies": [],
-				"browsers": {
-					"ie": "*"
-				}
-			});
-			sourceslib.getPolyfillMeta.withArgs('Array.isArray').resolves({
-				"dependencies": [],
-				"browsers": {
-					"ie": "*"
-				}
-			});
-			sourceslib.getPolyfillMeta.withArgs('Event').resolves({
-				"dependencies": [],
-				"browsers": {
-					"ie": "*"
-				}
-			});
-
-			UA.mockUAInstance.getFamily.returns('ie');
-			UA.mockUAInstance.satisfies.returns(true);
-
-			const polyfillio = require('../../../lib');
-
-			const input = {
-				features: {
-					'Element.prototype.placeholder': {
-						flags: new Set()
-					}
-				},
-				uaString: 'ie/8'
-			};
-
-			return polyfillio.getPolyfills(input).then((polyfills) => {
-				const polyfillNames = Object.keys(polyfills)
-				assert.deepEqual(polyfillNames, [
-					"Element.prototype.placeholder",
-					"setImmediate",
-					"Array.isArray",
-					"Event"
-				]);
-			});
-		});
-	});
-});

package/test/unit/lib/sources.js

@@ -1,146 +0,0 @@
-
-"use strict";
-
-const assert = require('proclaim');
-const mockery = require('mockery');
-const sinon = require('sinon');
-
-describe('lib/sources', () => {
-	let aliases;
-	let fs;
-	let sources;
-	let process;
-	let consoleMock;
-	let pathMock;
-
-	beforeEach(() => {
-
-		fs = require('../mock/graceful-fs.mock');
-		mockery.registerMock('graceful-fs', fs);
-		fs.readdir.yields(undefined, []);
-
-		process = require('../mock/process.mock');
-		mockery.registerMock('process', process);
-
-		consoleMock = require('../mock/console.mock');
-		mockery.registerMock('console', consoleMock);
-
-		pathMock = require('../mock/path.mock');
-		mockery.registerMock('path', pathMock);
-
-		aliases = {};
-		mockery.registerMock('../polyfills/__dist/aliases.json', aliases);
-	});
-
-	it('exports an object', () => {
-		sources = require('../../../lib/sources');
-		assert.isObject(sources);
-	});
-
-	it('has a getPolyfillMeta method', () => {
-		const sources = require('../../../lib/sources');
-		assert.isFunction(sources.getPolyfillMeta);
-	});
-
-	it('has a listPolyfills method', () => {
-		const sources = require('../../../lib/sources');
-		assert.isFunction(sources.listPolyfills);
-	});
-
-	it('has a listPolyfills method', () => {
-		const sources = require('../../../lib/sources');
-		assert.isFunction(sources.listPolyfills);
-	});
-
-	it('has a getConfigAliases method', () => {
-		const sources = require('../../../lib/sources');
-		assert.isFunction(sources.getConfigAliases);
-	});
-
-	it('has a streamPolyfillSource method', () => {
-		const sources = require('../../../lib/sources');
-		assert.isFunction(sources.streamPolyfillSource);
-	});
-
-	describe('sources.listPolyfills()', () => {
-		it('filters out json files from the polyfill directory', () => {
-			const spy = sinon.spy(Array.prototype, 'filter');
-			const sources = require('../../../lib/sources');
-
-			return sources.listPolyfills().then(() => {
-				spy.restore();
-				assert.equal(spy.lastCall.args[0]('aliases.json'), false);
-				assert.equal(spy.lastCall.args[0]('example.json'), false);
-			});
-		});
-
-		it('returns a promise which resolves with an array containing names for each polyfilled feature', () => {
-			fs.readdir.yields(undefined, ['Array.from', 'Symbol']);
-			const sources = require('../../../lib/sources');
-			return sources.listPolyfills().then(polyfills => assert.deepEqual(polyfills, ['Array.from', 'Symbol']));
-		});
-	});
-
-	describe('sources.getConfigAliases()', () => {
-		it('returns a promise which resolves with  an array of polyfills which are under the alias', () => {
-			const polyfills = ["Array.from", "Array.of", "Map", "Object.assign", "Object.is", "Promise", "Set", "Symbol", "WeakMap", "WeakSet"];
-			fs.readFile.yields(undefined, JSON.stringify({
-				es6: polyfills
-			}));
-			const sources = require('../../../lib/sources');
-			return sources.getConfigAliases('es6').then(config => assert.deepEqual(config, polyfills));
-		});
-
-		it('returns a promise which resolves to undefined if alias does not exist', () => {
-			fs.readFile.yields(undefined, JSON.stringify({
-				es6: ["Array.from", "Array.of", "Map", "Object.assign", "Object.is", "Promise", "Set", "Symbol", "WeakMap", "WeakSet"]
-			}));
-			const sources = require('../../../lib/sources');
-			return sources.getConfigAliases('es7').then(config => assert.isUndefined(config));
-		});
-	});
-
-	describe('sources.getPolyfillMeta()', () => {
-		const metadata = {
-			"aliases": ["es6"],
-			"browsers": {
-				"chrome": "<45"
-			},
-			"dependencies": ["Object.defineProperty"],
-			"spec": "https://tc39.github.io/ecma262/#sec-array.from",
-			"docs": "https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/from"
-		};
-
-		beforeEach(() => {
-			fs.readdir.yields(undefined, ['Array.from']);
-			fs.readFile.yields(undefined, JSON.stringify(metadata));
-		});
-
-		it('returns a promise which resolves with the metadata for a feature if it exists', () => {
-			const sources = require('../../../lib/sources');
-			return sources.getPolyfillMeta('Array.from').then(meta => assert.deepEqual(meta, metadata));
-		});
-	});
-
-	describe('sources.listPolyfills()', () => {
-		it('returns a promise which resolves with  an array containing names for each polyfilled feature', () => {
-			fs.readdir.yields(undefined, ['Array.from', 'Symbol']);
-			const sources = require('../../../lib/sources');
-			return sources.listPolyfills().then(polyfills => assert.deepEqual(polyfills, ['Array.from', 'Symbol']));
-		});
-	});
-
-	describe('sources.streamPolyfillSource()', () => {
-		it('returns a read-stream', () => {
-			pathMock.join.resetHistory();
-			pathMock.join.withArgs('../polyfills/__dist', 'Array.from', 'min.js').returns('../polyfills/__dist/Array.from/min.js');
-			pathMock.join.returnsArg(1);
-
-			fs.createReadStream.returns({ pipe: sinon.stub(), on: () => {} });
-			const sources = require('../../../lib/sources');
-			sources.streamPolyfillSource('Array.from', 'min');
-			assert.calledWithExactly(fs.createReadStream, '../polyfills/__dist/Array.from/min.js',
-			{ encoding: 'UTF-8' });
-		});
-	});
-});

package/test/unit/mock/aliases.mock.js

@@ -1,5 +0,0 @@
-'use strict';
-
-const sinon = require('sinon');
-
-module.exports = sinon.stub();

package/test/unit/mock/console.mock.js

@@ -1,7 +0,0 @@
-'use strict';
-
-const sinon = require('sinon');
-
-const console = module.exports = sinon.stub();
-
-console.log = sinon.stub();

package/test/unit/mock/denodeify.mock.js

@@ -1,5 +0,0 @@
-'use strict';
-
-const sinon = require('sinon');
-
-module.exports = sinon.stub();

package/test/unit/mock/from2-string.mock.js

@@ -1,5 +0,0 @@
-'use strict';
-
-const sinon = require('sinon');
-
-module.exports = sinon.stub();

package/test/unit/mock/graceful-fs.mock.js

@@ -1,10 +0,0 @@
-'use strict';
-
-const sinon = require('sinon');
-
-const fs = module.exports = sinon.stub();
-
-fs.readFile = sinon.stub();
-fs.readdir = sinon.stub();
-fs.createReadStream = sinon.stub();
-fs.stat = sinon.stub();

package/test/unit/mock/handlebars.mock.js

@@ -1,7 +0,0 @@
-'use strict';
-
-const sinon = require('sinon');
-
-module.exports = {
-	compile: sinon.stub()
-};

package/test/unit/mock/lazystream.mock.js

@@ -1,8 +0,0 @@
-'use strict';
-
-const sinon = require('sinon');
-
-module.exports = {
-	Readable: sinon.stub(),
-	Writable: sinon.stub()
-};

package/test/unit/mock/lru-cache.mock.js

@@ -1,14 +0,0 @@
-'use strict';
-
-const sinon = require('sinon');
-
-const lruCache = module.exports = sinon.stub();
-
-lruCache.set = sinon.stub();
-lruCache.get = sinon.stub();
-lruCache.instance = {
-	set: lruCache.set,
-	get: lruCache.get
-};
-
-lruCache.returns(lruCache.instance);

package/test/unit/mock/merge2.mock.js

@@ -1,13 +0,0 @@
-'use strict';
-
-const sinon = require('sinon');
-
-const merge2 = module.exports = sinon.stub();
-
-const merge2Instance = sinon.stub();
-
-merge2Instance.add = sinon.stub();
-
-merge2.merge2Instance = merge2Instance;
-
-merge2.returns(merge2Instance);

package/test/unit/mock/path.mock.js

@@ -1,7 +0,0 @@
-'use strict';
-
-const sinon = require('sinon');
-
-const path = module.exports = sinon.stub();
-
-path.join = sinon.stub();

package/test/unit/mock/process.mock.js

@@ -1,7 +0,0 @@
-'use strict';
-
-const sinon = require('sinon');
-
-const proc = module.exports = sinon.stub();
-
-proc.exit = sinon.stub();

package/test/unit/mock/sources.mock.js

@@ -1,10 +0,0 @@
-'use strict';
-
-const sinon = require('sinon');
-
-module.exports = {
-	getPolyfillMeta: sinon.stub().resolves(),
-	listPolyfills: sinon.stub().resolves(),
-	getConfigAliases: sinon.stub().resolves(),
-	streamPolyfillSource: sinon.stub(),
-};

package/test/unit/mock/stream-from-promise.mock.js

@@ -1,5 +0,0 @@
-'use strict';
-
-const sinon = require('sinon');
-
-module.exports = sinon.stub();

package/test/unit/mock/stream-to-string.mock.js

@@ -1,5 +0,0 @@
-'use strict';
-
-const sinon = require('sinon');
-
-module.exports = sinon.stub();

package/test/unit/mock/toposort.mock.js

@@ -1,7 +0,0 @@
-'use strict';
-
-const sinon = require('sinon');
-
-const toposort = module.exports = sinon.stub();
-
-toposort.array = sinon.stub();