polyfill-library 3.106.0 → 3.110.0

package/test/polyfills/server.js

@@ -1,332 +0,0 @@
-"use strict";
-
-require("hard-rejection/register");
-const semver = require("semver");
-const polyfillio = require('../../lib');
-const fs = require("fs");
-const promisify = require("util").promisify;
-const readFile = promisify(fs.readFile);
-const path = require("path");
-const handlebars = require("handlebars");
-
-const directorTemplate = handlebars.compile(
-	fs.readFileSync(path.join(__dirname, "./test-director.handlebars"), {
-		encoding: "UTF-8"
-	})
-);
-const runnerTemplate = handlebars.compile(
-	fs.readFileSync(path.join(__dirname, "./test-runner.handlebars"), {
-		encoding: "UTF-8"
-	})
-);
-
-function createPolyfillLibraryConfigFor(features, always) {
-	const config = {};
-	const flags = new Set(always ? ["always", "gated"] : []);
-	for (const feature of features.split(",")) {
-		config[feature] = { flags };
-	}
-
-	return config;
-}
-
-const compression = require('compression');
-const express = require("express");
-
-const app = express();
-app.use(compression());
-
-const port = 9876;
-const apicache = require('apicache');
-const cache = apicache.middleware;
-
-const cacheFor1Day = cache("1 day", () => true, {
-	appendKey: request => {
-		let key =
-			request.query.feature +
-			request.query.includePolyfills +
-			request.query.always;
-		if (request.query.always === "no") {
-			const ua = request.get("User-Agent");
-			key += polyfillio.normalizeUserAgent(ua);
-		}
-		return key;
-	}
-});
-
-app.get(["/test"], createEndpoint(runnerTemplate));
-app.get(["/"], createEndpoint(directorTemplate));
-app.get("/mocha.js", cacheFor1Day,(request, response) => {
-	response.sendFile(require.resolve("mocha/mocha.js"));
-});
-app.get("/mocha.css", cacheFor1Day, (request, response) => {
-	response.sendFile(require.resolve("mocha/mocha.css"));
-});
-app.get("/proclaim.js", cacheFor1Day, (request, response) => {
-	response.sendFile(require.resolve("proclaim/lib/proclaim.js"), "utf-8");
-});
-
-app.get(
-	"/polyfill.js",
-	cacheFor1Day,
-	async (request, response) => {
-		const ua = request.get("User-Agent");
-		const isIE8 = polyfillio.normalizeUserAgent(ua) === "ie/8.0.0";
-		const polyfillCombinations = (request.query.polyfillCombinations || "no") === "yes";
-		const feature = request.query.feature || "";
-		const includePolyfills = request.query.includePolyfills || "no";
-		const always = request.query.always || "no";
-
-		const headers = {
-			"Content-Type": "text/javascript; charset=utf-8"
-		};
-		response.status(200);
-		response.set(headers);
-
-		if (includePolyfills === "yes") {
-			const polyfillsWithTests = await testablePolyfills(isIE8);
-			let features = polyfillsWithTests.map(polyfill => polyfill.feature);
-
-			// Exclude polyfills which must not be loaded together
-			if (polyfillCombinations) {
-				// "timeZone.golden" and "timeZone.all" overlap.
-				// Including both is a user error.
-				features = features.filter((x) => {
-					return x !== 'Intl.DateTimeFormat.~timeZone.golden';
-				})
-			}
-
-			const parameters = {
-				features: createPolyfillLibraryConfigFor(
-					(feature && !polyfillCombinations) ? feature : features.join(","),
-					always === "yes"
-				),
-				minify: false,
-				stream: false,
-				uaString: always === "yes" ? "other/0.0.0" : request.get("user-agent")
-			};
-
-			const bundle = await polyfillio.getPolyfillString(parameters);
-			response.send(bundle);
-		} else {
-			response.send("");
-		}
-	}
-);
-
-app.get(
-	"/tests.js",
-	cacheFor1Day,
-	async (request, response) => {
-		const ua = request.get("User-Agent");
-		const isIE8 = polyfillio.normalizeUserAgent(ua) === "ie/8.0.0";
-		const feature = request.query.feature;
-		const requestedFeature = request.query.feature !== undefined;
-
-		const headers = {
-			"Content-Type": "text/javascript; charset=utf-8"
-		};
-		response.status(200);
-		response.set(headers);
-
-		const polyfills = await testablePolyfills(isIE8);
-
-		// Filter for querystring args
-		const features = requestedFeature
-			? polyfills.filter(polyfill => feature && feature.split(',').includes(polyfill.feature))
-			: polyfills;
-		const testSuite = features.map(feature => feature.testSuite).join("\n");
-
-		response.send(testSuite);
-	}
-);
-
-app.get(
-	"/sleep",
-	async (request, response) => {
-		const duration = Math.max(Number.parseInt(request.query.d), 1000);
-		await new Promise((resolve) => setTimeout(resolve, duration));
-
-		response.status(200);
-		response.send("");
-	}
-);
-
-app.listen(port, () => console.log(`Test server listening on port ${port}!`));
-
-const testablePolyfillsCache = {};
-async function testablePolyfills(isIE8, ua) {
-	if (testablePolyfillsCache[`isIE8:${isIE8};ua:${ua}`]) {
-		return testablePolyfillsCache[`isIE8:${isIE8};ua:${ua}`];
-	}
-
-	const polyfills = await polyfillio.listAllPolyfills();
-	const polyfilldata = [];
-
-	for (const polyfill of polyfills) {
-		const config = await polyfillio.describePolyfill(polyfill);
-		if (config && config.isTestable && config.isPublic && config.hasTests) {
-			if (isIE8 && !semver.satisfies("8.0.0", config.browsers.ie)) {
-				continue;
-			}
-			if (ua) {
-				const [family, version] = ua.split('/');
-				if (config.browsers[family] && !semver.satisfies(version, config.browsers[family])){
-					continue;
-				}
-				if (!config.browsers[family]) {
-					continue;
-				}
-			}
-		}
-		if (config && config.isTestable && config.isPublic && config.hasTests) {
-			const baseDirectory = path.resolve(__dirname, "../../polyfills");
-			const testFile = path.join(baseDirectory, config.baseDir, "/tests.js");
-			const testSuite = `describe('${polyfill}', function() {
-				it('passes the feature detect', function() {
-					proclaim.ok((function() {
-						return (${config.detectSource || 'false'});
-					}).call(window));
-				});
-
-				${await readFile(testFile)}
-			});`;
-			polyfilldata.push({
-				feature: polyfill,
-				testSuite
-			});
-		}
-	}
-
-	polyfilldata.sort(function (a, b) {
-		// console.clear() test must run first to preserve console output of other tests.
-		// to run first it must be last in the list.
-		if (a.feature === 'console.clear') {
-			return 1;
-		}
-
-		if (b.feature === 'console.clear') {
-			return -1;
-		}
-
-		return a.feature > b.feature ? -1 : 1;
-	});
-
-	testablePolyfillsCache[`isIE8:${isIE8};ua:${ua}`] = polyfilldata;
-	return polyfilldata;
-}
-
-function createEndpoint(template) {
-	return async (request, response) => {
-		const ua = request.get("User-Agent");
-		const isIE8 = polyfillio.normalizeUserAgent(ua) === "ie/8.0.0";
-		const featuresArgument = (request.query.feature || "").split(',').filter((feature) => !!feature);
-		const includePolyfills = request.query.includePolyfills || "no";
-		const polyfillCombinations = request.query.polyfillCombinations || "no";
-		const shard = request.query.shard || false;
-		const always = request.query.always || "no";
-
-		if (includePolyfills !== "yes" && includePolyfills !== "no") {
-			response.status(400);
-			response.send(
-				"includePolyfills query parameter is an invalid value, it can only be 'yes' or 'no'."
-			);
-			return;
-		}
-
-		if (always !== "yes" && always !== "no") {
-			response.status(400);
-			response.send(
-				"always query parameter is an invalid value, it can only be 'yes' or 'no'."
-			);
-			return;
-		}
-		let polyfills;
-		if (includePolyfills === 'yes' && always === 'no') {
-			polyfills = await testablePolyfills(isIE8, polyfillio.normalizeUserAgent(ua));
-		} else {
-			polyfills = await testablePolyfills(isIE8);
-		}
-
-		// Filter for querystring args
-		let features = (featuresArgument.length > 0)
-			? polyfills.filter(polyfill => {
-				return featuresArgument.includes(polyfill.feature);
-			})
-			: polyfills;
-		response.status(200);
-
-		if (shard) {
-			features = features.slice((shard - 1) * (features.length / 2), (shard) * (features.length / 2));
-		}
-
-		response.set({
-			"Content-Type": "text/html; charset=utf-8"
-		});
-
-		response.send(
-			template({
-				requestedFeature: features.length > 0,
-				features: features.map(f => f.feature).join(','),
-				includePolyfills: includePolyfills,
-				polyfillCombinations: polyfillCombinations,
-				always: always,
-				afterTestSuite: `
-				// During the test run, surface the test results in Browserstacks' preferred format
-				function run() {
-					// Given a test, get the first level suite that it is contained within
-					// Not the top level, the first one down.
-					function getFirstLevelSuite(test) {
-						var parent = test;
-						while (parent && parent.parent && parent.parent.parent) {
-							parent = parent.parent;
-						}
-						return parent.title;
-					}
-					var runner = mocha.run();
-					var results = {
-						state: 'complete',
-						passed: 0,
-						failed: 0,
-						total: 0,
-						duration: 0,
-						tests: [],
-						failingSuites: {},
-						testedSuites: [],
-						uaString: window.navigator.userAgent || 'unknown'
-					};
-					runner.on('pass', function(test) {
-						results.passed++;
-						results.total++;
-					});
-					runner.on('fail', function(test, err) {
-						// Get a set of all the suites with failing tests in them.
-						if (test.parent) {
-							results.failingSuites[getFirstLevelSuite(test)] = true;
-						}
-						results.failed++;
-						results.total++;
-						results.tests.push({
-							name: test.fullTitle(),
-							result: false,
-							message: err.message,
-							stack: err.stack,
-							failingSuite: getFirstLevelSuite(test)
-						});
-					});
-					runner.on('suite', function(suite) {
-						results.testedSuites.push(getFirstLevelSuite(suite));
-					});
-					runner.on('end', function() {
-						window.global_test_results = results;
-						if (parent && parent.receiveTestResults) {
-							var flist = ${JSON.stringify(features.map(f => f.feature))};
-							parent.receiveTestResults(flist, results);
-						}
-					});
-				}
-				run();`
-			})
-		);
-	};
-}

package/test/polyfills/test-all-features.js

@@ -1,28 +0,0 @@
-"use strict";
-
-const path = require('path');
-const execa = require('execa');
-const globby = require('globby');
-
-(async function () {
-	let feature;
-	try {
-		// This turns ./polyfills/Array/from/tests.js into Array.from, which is the format that the Karma config accepts in the `--features` flag.
-		const polyfillsWhichHaveTests = await globby(['polyfills/**/tests.js', '!polyfills/__dist'], { transform: (entry) => entry.replace('polyfills/', '').replace('/tests.js','').replace(/\//g, '.') });
-		for (feature of polyfillsWhichHaveTests) {
-			console.log(`Testing ${feature}`);
-			const result = execa('karma', ['start', path.join(__dirname, '../../', 'karma.conf.js'), `--browserstack`, `--features=${feature}`], {
-				preferLocal: true
-			});
-			result.stdout.pipe(process.stdout);
-			result.stderr.pipe(process.stderr);
-			await result;
-		}
-	} catch (error) {
-		console.log(`Errors found testing ${feature}`);
-		console.error(error.stderr || error.stdout);
-		console.log(`Errors found testing ${feature}`);
-		// eslint-disable-next-line unicorn/no-process-exit
-		process.exit(1);
-	}
-}());

package/test/polyfills/test-director.handlebars

@@ -1,135 +0,0 @@
-<!doctype html>
-<html>
-<head>
-	<meta charset="utf-8">
-	<meta http-equiv="X-UA-Compatible" content="IE=edge">
-	<title>polyfill-library test director</title>
-
-	<style>
-		* { box-sizing: border-box; }
-		html, body { width: 100%; height: 100%; padding:0; margin: 0; overflow: hidden; }
-		#runner { width: 100%; height: 70%; z-index:1; overflow: auto; border: none; display: block;}
-		#log { width: 100%; height:30%; z-index: 2; font-size: 14px; font-family: monospace; border: 0; background: white; background: rgba(255,255,255,0.8); padding: 3px 10px; overflow-y: auto; }
-		#log p { margin: 0.2em 0; }
-		.pass { color: #6b6;}
-		.fail { color: white; background: red; display: inline-block; padding: 1px 4px; }
-	</style>
-
-	<script>
-		var runner, timer;
-		var globalresults = {
-			passed: 0,
-			failed: 0,
-			total: 0,
-			duration: 0,
-			tests: [],
-			failingSuites: {},
-			testedSuites: [],
-			uaString: 'unknown'
-		};
-		var queue = "{{features}}".split(',');
-		var runnerCompletedCount = 0;
-		var runnerTotalCount = queue.length;
-		var windowQueryString = "?includePolyfills={{{includePolyfills}}}&always={{{always}}}&polyfillCombinations={{{polyfillCombinations}}}";
-		var timeout = 30000;
-		var timeoutMaxRetries = 2;
-		var timeoutRetryCount = 0;
-		window.onload = function() {
-			runner = document.getElementById('runner');
-			if (queue.length) {
-				executeTest();
-			} else {
-				log('No features to test');
-			}
-		};
-		function executeTest() {
-			var feature = queue.pop();
-			var url = '/test' + windowQueryString + '&feature=' + feature;
-			log('['+(runnerCompletedCount+1)+'/'+runnerTotalCount+'] Testing <a target="runner" href="'+url+'">'+feature+'</a>...');
-			runner.src = url;
-			timer = setTimeout(function() {
-				receiveTestResults([feature]);
-			}, timeout);
-		}
-		function postResult(featureName, result) {
-			if (window.top !== this && parent && 'receiveTestResult' in parent) {
-				parent.receiveTestResult(featureName, result, '{{{mode}}}');
-			} else if (window.top !== this && parent && 'postMessage' in parent && 'JSON' in window) {
-				parent.postMessage(JSON.stringify({featureName:featureName, result:result, mode:'{{{mode}}}'}), '*');
-			}
-		}
-		function receiveTestResults(featureList, results) {
-			var resultsummary = [], featureName;
-			clearTimeout(timer);
-			if (!results) {
-				resultsummary.push('<span class="fail">Timeout waiting for results</span>');
-				if (timeoutRetryCount < timeoutMaxRetries) {
-					timeoutRetryCount++;
-					resultsummary.push('Scheduling retry ('+timeoutRetryCount+'/'+timeoutMaxRetries+')');
-					queue = queue.concat(featureList);
-				} else {
-					globalresults.failed++;
-					globalresults.total++;
-					for (var i=0,s=featureList.length; i<s; i++) {
-						globalresults.failingSuites[featureList[i]+' (timeout after '+timeout+'ms, '+timeoutMaxRetries+' retries)'] = true;
-						postResult(featureList[i], 'timeout');
-					}
-					resultsummary.push('No more retries left');
-				}
-			} else {
-				if (results.passed) globalresults.passed += results.passed;
-				if (results.failed) globalresults.failed += results.failed;
-				if (results.total) globalresults.total += results.total;
-				if (results.duration) globalresults.duration += results.duration;
-				if (results.tests) globalresults.tests = globalresults.tests.concat(results.tests);
-				if (results.testedSuites) globalresults.testedSuites = globalresults.testedSuites.concat(results.testedSuites);
-				if (results.uaString) globalresults.uaString = results.uaString;
-				if (results.failingSuites) {
-					for (var f in results.failingSuites) {
-						if (results.failingSuites.hasOwnProperty(f)) {
-							globalresults.failingSuites[f] = results.failingSuites[f];
-						}
-					}
-				}
-				if (results.testedSuites) {
-					for (var t in results.testedSuites) {
-						featureName = results.testedSuites[t];
-						postResult(featureName, (results.failingSuites && featureName in results.failingSuites) ? 'fail' : 'pass');
-					}
-				}
-				timeoutRetryCount = 0;
-				if (results.passed) resultsummary.push('<span class="pass">'+results.passed+' pass</span>');
-				if (results.failed) resultsummary.push('<span class="fail">'+results.failed+' fail</span>');
-				if (!resultsummary.length) resultsummary.push('No tests to run');
-			}
-			log(resultsummary.join(', ') + ' ('+featureList.join(', ')+')');
-			runnerCompletedCount = runnerTotalCount - queue.length;
-			if (!queue.length) {
-				globalresults.state = 'complete';
-				globalresults.runnerCount = runnerTotalCount;
-				window.global_test_results = window.global_test_progress = globalresults;
-				resultsummary = [];
-				if (globalresults.passed) resultsummary.push('<span class="pass">'+globalresults.passed+' pass</span>');
-				if (globalresults.failed) resultsummary.push('<span class="fail">'+globalresults.failed+' fail</span>');
-				if (!resultsummary.length) resultsummary.push('No tests to run');
-				log('<strong>All tests complete, result data populated into global_test_results.  Total: '+resultsummary.join(', ')+'.</strong>');
-			} else {
-				window.global_test_progress = { state: 'running', runnerCompletedCount: runnerCompletedCount, runnerCount: runnerTotalCount, failed: globalresults.failed, passed: globalresults.passed };
-				executeTest();
-			}
-		}
-		function log(str) {
-			var t = new Date();
-			var el = document.getElementById('log');
-			var p = document.createElement('p');
-			p.innerHTML = ((t.getHours()<10)?'0':'') + t.getHours() + ":" + ((t.getMinutes()<10)?'0':'') + t.getMinutes() + ":" + ((t.getSeconds()<10)?'0':'') + t.getSeconds() + ' ' + str;
-			el.appendChild(p);
-			el.scrollTop = 99999999;
-		}
-	</script>
-</head>
-<body>
-	<iframe name='runner' id='runner' frameborder='0'></iframe>
-	<div id='log'></div>
-</body>
-</html>

package/test/polyfills/test-individual-feature.js

@@ -1,142 +0,0 @@
-"use strict";
-
-// Ensure Array.prototype.flatMap exists
-// We support NodeJS 8 and above and Array.prototype.flatMap was added in NodeJS 11
-require('array.prototype.flatmap').shim();
-const intersection = require('lodash').intersection;
-const fs = require('fs');
-const path = require('path');
-const execa = require('execa');
-const globby = require('globby');
-const polyfillLibrary = require('../../lib');
-const feature = process.argv.slice(2)[0];
-
-const featureToFolder = feature => feature.replace(/\./g, path.sep);
-
-function generateDependencyTreeForFeature(feature) {
-	return polyfillLibrary.getPolyfills({
-		features: {
-			[feature]: {}
-		},
-		unknown: 'polyfill',
-		uaString: ''
-	}).then(Object.keys);
-}
-
-function hasOwnProperty (object, property) {
-	return Object.prototype.hasOwnProperty.call(object, property);
-}
-
-function findDifferenceInObjects(inclusionObject, exclusionObject) {
-	const result = {};
-	for (const [key, value] of Object.entries(inclusionObject)) {
-		if (hasOwnProperty(exclusionObject, key)) {
-			if (exclusionObject[key] !== value) {
-				result[key] = value;
-			}
-		} else {
-			result[key] = value;
-		}
-	}
-	return result;
-}
-const TOML = require('@iarna/toml');
-async function findAllThirdPartyPolyfills () {
-	const configs = await globby(['polyfills/**/config.toml', '!polyfills/__dist']);
-	return configs.map(file => {
-		const config = TOML.parse(fs.readFileSync(path.join(__dirname, '../../', file), 'utf-8'));
-		return config.install && config.install.module;
-	}).filter(thirdPartyPolyfills => thirdPartyPolyfills !== undefined);
-}
-
-async function featureRequiresTesting(feature) {
-
-	const filesWhichChanged = execa.commandSync('git diff --name-only origin/master HEAD').stdout.split('\n');
-
-	// if any of the dependencies in the tree from the feature is the same as latest commit, run the tests
-	const dependencies = await generateDependencyTreeForFeature(feature);
-	const dependencyFolders = dependencies.map(feature => `polyfills/${featureToFolder(feature)}`);
-	const thirdPartyPolyfills = await findAllThirdPartyPolyfills();
-
-	const filesRequiredByFeature = dependencyFolders.flatMap(folder => {
-		return [
-			folder + '/config.toml',
-			folder + '/polyfill.js'
-		];
-	});
-
-	const testsForFeature = `polyfills/${featureToFolder(feature)}/tests.js`;
-	// const detectForFeature = `polyfills/${featureToFolder(feature)}/detect.js`;
-
-	const testsForFeatureHaveNotChanged = !filesWhichChanged.includes(testsForFeature);
-	const filesRequiredByFeatureWhichHaveChanged = intersection(filesRequiredByFeature, filesWhichChanged);
-	const filesRequiredByFeatureHasNotChanged = filesRequiredByFeatureWhichHaveChanged.length === 0;
-	const libraryFolderHasNotChanged = !filesWhichChanged.some(file => file.startsWith('lib/'));
-	const karmaPolyfillPluginHasNotChanged = !filesWhichChanged.includes('karma-polyfill-library-plugin.js');
-	const packageJsonDependenciesFromMaster = JSON.parse(execa.commandSync('git show origin/master:package.json').stdout).dependencies;
-	const packageJsonDependenciesFromHead = JSON.parse(fs.readFileSync(path.join(__dirname, '../../package.json'), 'utf-8')).dependencies;
-	const packageJsonDependenciesChanges = Object.keys(findDifferenceInObjects(packageJsonDependenciesFromHead, packageJsonDependenciesFromMaster));
-	const thirdPartyPolyfillsWhichHaveBeenAddedOrChanged = intersection(packageJsonDependenciesChanges, thirdPartyPolyfills);
-
-	if (!testsForFeatureHaveNotChanged) {
-		console.log(`Running tests for ${feature} because the tests have changed.`);
-		return true;
-	}
-
-	if (!filesRequiredByFeatureHasNotChanged) {
-		console.log(`Running tests for ${feature} because one or more of the files it depends on has changed.`);
-		console.log(`The files which changed were ${filesRequiredByFeatureWhichHaveChanged}`);
-		return true;
-	}
-	if (!libraryFolderHasNotChanged) {
-		console.log(`Running tests for ${feature} because one or more of the files of the core polyfill-library has changed.`);
-		return true;
-	}
-	if (!karmaPolyfillPluginHasNotChanged) {
-		console.log(`Running tests for ${feature} because the Karma plugin used for testing has changed.`);
-		return true;
-	}
-
-	const thirdPartyDependenciesForFeature = filesRequiredByFeature.filter(file => file.endsWith('/config.toml')).map(file => {
-		const config = TOML.parse(fs.readFileSync(path.join(__dirname, '../../', file), 'utf-8'));
-		return config.install && config.install.module;
-	}).filter(thirdPartyPolyfills => thirdPartyPolyfills !== undefined);
-
-	const thirdPartyPolyfillHasBeenAddedOrChangedForFeature = intersection(thirdPartyPolyfillsWhichHaveBeenAddedOrChanged, thirdPartyDependenciesForFeature).length > 0;
-	const packageJsonHasOnlyHadThirdPartyPolyfillChangesAppliedToIt = packageJsonDependenciesChanges.every(dep => thirdPartyPolyfills.includes(dep));
-
-	if (thirdPartyPolyfillHasBeenAddedOrChangedForFeature) {
-		console.log(`Running tests for ${feature} because one of the package.json.dependencies it is built from has changed.`);
-		return true;
-	}
-	if (packageJsonHasOnlyHadThirdPartyPolyfillChangesAppliedToIt) {
-		return false;
-	}
-
-	console.log(`Running tests for ${feature} because... Well, I'm not sure why. One of these might be why ${filesWhichChanged.join(' ')}`);
-	return true;
-}
-
-(async function () {
-	try {
-		if (await featureRequiresTesting(feature)) {
-			console.log(`Testing ${feature}`);
-			const result = execa('karma', ['start', path.join(__dirname, '../../', 'karma.conf.js'), `--browserstack`, `--features=${feature}`], {
-				preferLocal: true
-			});
-			result.stdout.pipe(process.stdout);
-			result.stderr.pipe(process.stderr);
-			await result;
-		} else {
-			console.log(`${feature} has not changed, no need to run the tests.`);
-			// eslint-disable-next-line unicorn/no-process-exit
-			process.exit(0);
-		}
-	} catch (error) {
-		console.log(`Errors found testing ${feature}`);
-		console.error(error.stderr || error.stdout || error);
-		console.log(`Errors found testing ${feature}`);
-		// eslint-disable-next-line unicorn/no-process-exit
-		process.exit(1);
-	}
-}());