core-js-compat 3.20.3 → 3.22.0

package/README.md

@@ -3,42 +3,52 @@
 [`core-js-compat` package](https://github.com/zloirock/core-js/tree/master/packages/core-js-compat) contains data about the necessity of [`core-js`](https://github.com/zloirock/core-js) modules and API for getting a list of required core-js modules by browserslist query.
 
 ```js
+import compat from 'core-js-compat';
+
 const {
-  list,                  // array of required modules
-  targets,               // object with targets for each module
-} = require('core-js-compat')({
-  targets: '> 2.5%',     // browserslist query or object of minimum environment versions to support
-  filter: /^(es|web)\./, // optional filter - string-prefix, regexp or list of modules
-  version: '3.20',       // used `core-js` version, by default - the latest
+  list,                         // array of required modules
+  targets,                      // object with targets for each module
+} = compat({
+  targets: '> 1%',              // browserslist query or object of minimum environment versions to support, see below
+  modules: [                    // optional list / filter of modules - regex, sting or an array of them:
+    'core-js/actual',           // - an entry point
+    'esnext.array.unique-by',   // - a module name (or just a start of a module name)
+    /^web\./,                   // - regex that a module name must satisfy
+  ],
+  exclude: [                    // optional list / filter of modules to exclude, the signature is similar to `modules` option
+    'web.atob',
+  ],
+  version: '3.22',              // used `core-js` version, by default - the latest
 });
 
 console.log(targets);
 /* =>
 {
-  'es.symbol.match-all': { ios: '12.2-12.4' },
-  'es.array.unscopables.flat': { ios: '12.2-12.4' },
-  'es.array.unscopables.flat-map': { ios: '12.2-12.4' },
-  'es.math.hypot': { chrome: '77' },
-  'es.promise.all-settled': { firefox: '69', ios: '12.2-12.4' },
-  'es.promise.finally': { ios: '12.2-12.4' },
-  'es.string.match-all': { chrome: '77', firefox: '69', ios: '12.2-12.4' },
-  'es.string.replace': { firefox: '69', ios: '12.2-12.4' },
-  'es.typed-array.float32-array': { ios: '12.2-12.4' },
-  'es.typed-array.float64-array': { ios: '12.2-12.4' },
-  'es.typed-array.int8-array': { ios: '12.2-12.4' },
-  'es.typed-array.int16-array': { ios: '12.2-12.4' },
-  'es.typed-array.int32-array': { ios: '12.2-12.4' },
-  'es.typed-array.uint8-array': { ios: '12.2-12.4' },
-  'es.typed-array.uint8-clamped-array': { ios: '12.2-12.4' },
-  'es.typed-array.uint16-array': { ios: '12.2-12.4' },
-  'es.typed-array.uint32-array': { ios: '12.2-12.4' },
-  'es.typed-array.from': { ios: '12.2-12.4' },
-  'es.typed-array.of': { ios: '12.2-12.4' },
-  'web.dom-collections.iterator': { ios: '12.2-12.4' },
-  'web.immediate': { chrome: '77', firefox: '69', ios: '12.2-12.4' },
-  'web.url': { ios: '12.2-12.4' },
-  'web.url.to-json': { ios: '12.2-12.4' },
-  'web.url-search-params': { ios: '12.2-12.4' }
+  'es.error.cause': { ios: '14.5-14.8', samsung: '16.0' },
+  'es.aggregate-error.cause': { ios: '14.5-14.8', samsung: '16.0' },
+  'es.array.at': { ios: '14.5-14.8' },
+  'es.object.has-own': { ios: '14.5-14.8', samsung: '16.0' },
+  'es.string.at-alternative': { ios: '14.5-14.8' },
+  'es.typed-array.at': { ios: '14.5-14.8' },
+  'es.typed-array.set': { samsung: '16.0' },
+  'esnext.array.find-last': { firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'esnext.array.find-last-index': { firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'esnext.array.group-by': { chrome: '98', edge: '99', firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'esnext.array.group-by-to-map': { chrome: '98', edge: '99', firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'esnext.array.to-reversed': { chrome: '98', edge: '99', firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'esnext.array.to-sorted': { chrome: '98', edge: '99', firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'esnext.array.to-spliced': { chrome: '98', edge: '99', firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'esnext.array.unique-by': { chrome: '98', edge: '99', firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'esnext.array.with': { chrome: '98', edge: '99', firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'esnext.typed-array.find-last': { firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'esnext.typed-array.find-last-index': { firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'esnext.typed-array.to-reversed': { chrome: '98', edge: '99', firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'esnext.typed-array.to-sorted': { chrome: '98', edge: '99', firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'esnext.typed-array.to-spliced': { chrome: '98', edge: '99', firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'esnext.typed-array.with': { chrome: '98', edge: '99', firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'web.dom-exception.stack': { chrome: '98', edge: '99', ios: '14.5-14.8', samsung: '16.0' },
+  'web.immediate': { chrome: '98', edge: '99', firefox: '98', ios: '14.5-14.8', samsung: '16.0' },
+  'web.structured-clone': { chrome: '98', edge: '99', firefox: '98', ios: '14.5-14.8', samsung: '16.0' }
 }
 */
 ```
@@ -74,9 +84,9 @@ console.log(targets);
 
 ```js
 // equals of of the method from the example above
-require('core-js-compat/compat')({ targets, filter, version }); // => { list: Array<ModuleName>, targets: { [ModuleName]: { [EngineName]: EngineVersion } } }
+require('core-js-compat/compat')({ targets, modules, version }); // => { list: Array<ModuleName>, targets: { [ModuleName]: { [EngineName]: EngineVersion } } }
 // or
-require('core-js-compat').compat({ targets, filter, version }); // => { list: Array<ModuleName>, targets: { [ModuleName]: { [EngineName]: EngineVersion } } }
+require('core-js-compat').compat({ targets, modules, version }); // => { list: Array<ModuleName>, targets: { [ModuleName]: { [EngineName]: EngineVersion } } }
 
 // full compat data:
 require('core-js-compat/data'); // => { [ModuleName]: { [EngineName]: EngineVersion } }
@@ -94,9 +104,9 @@ require('core-js-compat/modules'); // => Array<ModuleName>
 require('core-js-compat').modules; // => Array<ModuleName>
 
 // the subset of modules which available in the passed `core-js` version:
-require('core-js-compat/get-modules-list-for-target-version')('3.20'); // => Array<ModuleName>
+require('core-js-compat/get-modules-list-for-target-version')('3.22'); // => Array<ModuleName>
 // or
-require('core-js-compat').getModulesListForTargetVersion('3.20'); // => Array<ModuleName>
+require('core-js-compat').getModulesListForTargetVersion('3.22'); // => Array<ModuleName>
 ```
 
 If you want to add new / update data about modules required for target engines, [follow this instruction](https://github.com/zloirock/core-js/blob/master/CONTRIBUTING.md#updating-core-js-compat-data).

package/compat.js

@@ -1,19 +1,34 @@
 'use strict';
-const { compare, has, intersection } = require('./helpers');
+const { compare, filterOutStabilizedProposals, has, intersection } = require('./helpers');
 const data = require('./data');
+const entries = require('./entries');
 const getModulesListForTargetVersion = require('./get-modules-list-for-target-version');
-const modules = require('./modules');
+const allModules = require('./modules');
 const targetsParser = require('./targets-parser');
 
-function checkModule(name, targets) {
-  if (!has(data, name)) throw new TypeError(`Incorrect module: ${ name }`);
+function getModules(filter) {
+  if (typeof filter == 'string') {
+    if (has(entries, filter)) return entries[filter];
+    return allModules.filter(it => it.startsWith(filter));
+  } else if (filter instanceof RegExp) return allModules.filter(it => filter.test(it));
+  throw TypeError('Wrong filter!');
+}
 
-  const requirements = data[name];
+function normalizeModules(option) {
+  // TODO: use `.flatMap` in core-js@4
+  return new Set(Array.isArray(option) ? [].concat.apply([], option.map(getModules)) : getModules(option));
+}
+
+function checkModule(name, targets) {
   const result = {
-    required: false,
+    required: !targets,
     targets: {},
   };
 
+  if (!targets) return result;
+
+  const requirements = data[name];
+
   for (const [engine, version] of targets) {
     if (!has(requirements, engine) || compare(version, '<', requirements[engine])) {
       result.required = true;
@@ -24,28 +39,35 @@ function checkModule(name, targets) {
   return result;
 }
 
-module.exports = function ({ targets, filter, version }) {
-  const parsedTargets = targetsParser(targets);
+module.exports = function ({
+  filter = null, // TODO: Obsolete, remove from `core-js@4`
+  modules = null,
+  exclude = [],
+  targets = null,
+  version = null,
+} = {}) {
+  if (modules == null) modules = filter;
+
+  const parsedTargets = targets ? targetsParser(targets) : null;
 
   const result = {
     list: [],
     targets: {},
   };
 
-  let $modules = Array.isArray(filter) ? filter : modules;
+  exclude = normalizeModules(exclude);
 
-  if (filter instanceof RegExp) {
-    $modules = $modules.filter(it => filter.test(it));
-  } else if (typeof filter == 'string') {
-    $modules = $modules.filter(it => it.startsWith(filter));
-  }
+  modules = modules ? [...normalizeModules(modules)] : allModules;
 
-  if (version) {
-    $modules = intersection($modules, getModulesListForTargetVersion(version));
-  }
+  if (exclude.size) modules = modules.filter(it => !exclude.has(it));
 
-  for (const key of $modules) {
+  modules = intersection(modules, version ? getModulesListForTargetVersion(version) : allModules);
+
+  modules = filterOutStabilizedProposals(modules);
+
+  for (const key of modules) {
     const check = checkModule(key, parsedTargets);
+
     if (check.required) {
       result.list.push(key);
       result.targets[key] = check.targets;

package/data.json

@@ -230,7 +230,9 @@
     "ios": "15.0",
     "node": "16.11",
     "opera": "80",
-    "safari": "15.0"
+    "opera_mobile": "66",
+    "safari": "15.0",
+    "samsung": "17.0"
   },
   "es.error.to-string": {
     "android": "4.4.3",
@@ -244,6 +246,7 @@
     "node": "0.11.13",
     "opera": "20",
     "opera_mobile": "20",
+    "rhino": "1.7.14",
     "safari": "8.0",
     "samsung": "2.0"
   },
@@ -271,7 +274,9 @@
     "ios": "15.0",
     "node": "16.11",
     "opera": "80",
-    "safari": "15.0"
+    "opera_mobile": "66",
+    "safari": "15.0",
+    "samsung": "17.0"
   },
   "es.array.at": {
     "android": "92",
@@ -280,6 +285,7 @@
     "edge": "92",
     "electron": "14.0",
     "firefox": "90",
+    "ios": "15.4",
     "node": "16.6",
     "opera": "78",
     "opera_mobile": "65",
@@ -740,6 +746,7 @@
     "node": "0.11.9",
     "opera": "19",
     "opera_mobile": "19",
+    "rhino": "1.7.14",
     "safari": "7.1",
     "samsung": "2.0"
   },
@@ -981,6 +988,7 @@
     "node": "12.0",
     "opera": "58",
     "opera_mobile": "50",
+    "rhino": "1.7.14",
     "safari": "12.1",
     "samsung": "10.0"
   },
@@ -1321,6 +1329,7 @@
     "node": "0.11.13",
     "opera": "21",
     "opera_mobile": "21",
+    "rhino": "1.7.14",
     "safari": "9.0",
     "samsung": "2.0"
   },
@@ -1425,6 +1434,7 @@
     "node": "0.11.13",
     "opera": "22",
     "opera_mobile": "22",
+    "rhino": "1.7.14",
     "safari": "11.0",
     "samsung": "3.0"
   },
@@ -1439,6 +1449,7 @@
     "node": "0.11.13",
     "opera": "22",
     "opera_mobile": "22",
+    "rhino": "1.7.14",
     "safari": "9.0",
     "samsung": "3.0"
   },
@@ -1453,6 +1464,7 @@
     "node": "6.5",
     "opera": "38",
     "opera_mobile": "38",
+    "rhino": "1.7.14",
     "safari": "11",
     "samsung": "5.0"
   },
@@ -1593,6 +1605,7 @@
     "node": "7.0",
     "opera": "41",
     "opera_mobile": "41",
+    "rhino": "1.7.14",
     "safari": "10.1",
     "samsung": "6.0"
   },
@@ -1622,6 +1635,7 @@
     "node": "12.0",
     "opera": "60",
     "opera_mobile": "52",
+    "rhino": "1.7.14",
     "safari": "12.1",
     "samsung": "11.0"
   },
@@ -1691,9 +1705,12 @@
     "edge": "93",
     "electron": "14.0",
     "firefox": "92",
+    "ios": "15.4",
     "node": "16.9",
     "opera": "79",
-    "safari": "15.4"
+    "opera_mobile": "66",
+    "safari": "15.4",
+    "samsung": "17.0"
   },
   "es.object.is": {
     "android": "4.1",
@@ -1871,6 +1888,7 @@
     "node": "7.0",
     "opera": "41",
     "opera_mobile": "41",
+    "rhino": "1.7.14",
     "safari": "10.1",
     "samsung": "6.0"
   },
@@ -2278,6 +2296,7 @@
     "edge": "92",
     "electron": "14.0",
     "firefox": "90",
+    "ios": "15.4",
     "node": "16.6",
     "opera": "78",
     "opera_mobile": "65",
@@ -2426,6 +2445,7 @@
     "node": "1.0",
     "opera": "28",
     "opera_mobile": "28",
+    "rhino": "1.7.14",
     "safari": "9.0",
     "samsung": "3.4"
   },
@@ -2586,6 +2606,7 @@
     "opera": "15",
     "opera_mobile": "15",
     "phantom": "2.0",
+    "rhino": "1.7.14",
     "safari": "6.0",
     "samsung": "1.0"
   },
@@ -2665,6 +2686,7 @@
     "opera": "15",
     "opera_mobile": "15",
     "phantom": "2.0",
+    "rhino": "1.7.14",
     "safari": "6.0",
     "samsung": "1.0"
   },
@@ -2680,6 +2702,7 @@
     "opera": "15",
     "opera_mobile": "15",
     "phantom": "2.0",
+    "rhino": "1.7.14",
     "safari": "6.0",
     "samsung": "1.0"
   },
@@ -2711,6 +2734,7 @@
     "opera": "15",
     "opera_mobile": "15",
     "phantom": "2.0",
+    "rhino": "1.7.14",
     "safari": "6.0",
     "samsung": "1.0"
   },
@@ -2911,6 +2935,7 @@
     "edge": "92",
     "electron": "14.0",
     "firefox": "90",
+    "ios": "15.4",
     "node": "16.6",
     "opera": "78",
     "opera_mobile": "65",
@@ -3179,7 +3204,9 @@
     "ios": "14.5",
     "node": "17.0",
     "opera": "81",
-    "safari": "14.1"
+    "opera_mobile": "67",
+    "safari": "14.1",
+    "samsung": "17.0"
   },
   "es.typed-array.slice": {
     "android": "45",
@@ -3234,6 +3261,7 @@
     "node": "0.11.0",
     "opera": "16",
     "opera_mobile": "16",
+    "rhino": "1.7.14",
     "safari": "7.1",
     "samsung": "1.5"
   },
@@ -3334,6 +3362,7 @@
     "edge": "92",
     "electron": "14.0",
     "firefox": "90",
+    "ios": "15.4",
     "node": "16.6",
     "opera": "78",
     "opera_mobile": "65",
@@ -3348,7 +3377,9 @@
     "deno": "1.16",
     "edge": "97",
     "electron": "17.0",
+    "ios": "15.4",
     "opera": "83",
+    "opera_mobile": "68",
     "safari": "15.4"
   },
   "esnext.array.find-last-index": {
@@ -3357,7 +3388,9 @@
     "deno": "1.16",
     "edge": "97",
     "electron": "17.0",
+    "ios": "15.4",
     "opera": "83",
+    "opera_mobile": "68",
     "safari": "15.4"
   },
   "esnext.array.group-by": {},
@@ -3401,6 +3434,7 @@
     "node": "12.0",
     "opera": "58",
     "opera_mobile": "50",
+    "rhino": "1.7.14",
     "safari": "12.1",
     "samsung": "10.0"
   },
@@ -3461,9 +3495,12 @@
     "edge": "93",
     "electron": "14.0",
     "firefox": "92",
+    "ios": "15.4",
     "node": "16.9",
     "opera": "79",
-    "safari": "15.4"
+    "opera_mobile": "66",
+    "safari": "15.4",
+    "samsung": "17.0"
   },
   "esnext.object.iterate-entries": {},
   "esnext.object.iterate-keys": {},
@@ -3571,6 +3608,7 @@
     "edge": "92",
     "electron": "14.0",
     "firefox": "90",
+    "ios": "15.4",
     "node": "16.6",
     "opera": "78",
     "opera_mobile": "65",
@@ -3585,7 +3623,9 @@
     "deno": "1.16",
     "edge": "97",
     "electron": "17.0",
+    "ios": "15.4",
     "opera": "83",
+    "opera_mobile": "68",
     "safari": "15.4"
   },
   "esnext.typed-array.find-last-index": {
@@ -3594,7 +3634,9 @@
     "deno": "1.16",
     "edge": "97",
     "electron": "17.0",
+    "ios": "15.4",
     "opera": "83",
+    "opera_mobile": "68",
     "safari": "15.4"
   },
   "esnext.typed-array.group-by": {},
@@ -3612,6 +3654,34 @@
   "esnext.weak-set.delete-all": {},
   "esnext.weak-set.from": {},
   "esnext.weak-set.of": {},
+  "web.atob": {
+    "android": "37",
+    "chrome": "34",
+    "deno": "1.0",
+    "edge": "16",
+    "electron": "0.20",
+    "firefox": "27",
+    "ios": "10.3",
+    "opera": "10.5",
+    "opera_mobile": "10.5",
+    "safari": "10.1",
+    "samsung": "2.0"
+  },
+  "web.btoa": {
+    "android": "3.0",
+    "chrome": "4",
+    "deno": "1.0",
+    "edge": "16",
+    "electron": "0.20",
+    "firefox": "27",
+    "ios": "1.0",
+    "node": "17.5",
+    "opera": "10.5",
+    "opera_mobile": "10.5",
+    "phantom": "1.9",
+    "safari": "3.0",
+    "samsung": "1.0"
+  },
   "web.dom-collections.for-each": {
     "android": "58",
     "chrome": "58",
@@ -3657,7 +3727,7 @@
     "samsung": "5.0"
   },
   "web.dom-exception.stack": {
-    "deno": "1.7",
+    "deno": "1.15",
     "firefox": "37",
     "node": "17.0"
   },