core-js-bundle 3.27.2 → 3.28.0

package/README.md

@@ -6,11 +6,10 @@
 
 </div>
 
-> Modular standard library for JavaScript. Includes polyfills for [ECMAScript up to 2023](https://github.com/zloirock/core-js#ecmascript): [promises](https://github.com/zloirock/core-js#ecmascript-promise), [symbols](https://github.com/zloirock/core-js#ecmascript-symbol), [collections](https://github.com/zloirock/core-js#ecmascript-collections), iterators, [typed arrays](https://github.com/zloirock/core-js#ecmascript-typed-arrays), many other features, [ECMAScript proposals](https://github.com/zloirock/core-js#ecmascript-proposals), [some cross-platform WHATWG / W3C features and proposals](#web-standards) like [`URL`](https://github.com/zloirock/core-js#url-and-urlsearchparams). You can load only required features or use it without global namespace pollution.
-
-## As advertising: the author is looking for a good job -)
+**I highly recommend reading this: [So, what's next?](https://github.com/zloirock/core-js/blob/master/docs/2023-02-14-so-whats-next.md)**
+---
 
-## [core-js@3, babel and a look into the future](https://github.com/zloirock/core-js/tree/master/docs/2019-03-19-core-js-3-babel-and-a-look-into-the-future.md)
+> Modular standard library for JavaScript. Includes polyfills for [ECMAScript up to 2023](https://github.com/zloirock/core-js#ecmascript): [promises](https://github.com/zloirock/core-js#ecmascript-promise), [symbols](https://github.com/zloirock/core-js#ecmascript-symbol), [collections](https://github.com/zloirock/core-js#ecmascript-collections), iterators, [typed arrays](https://github.com/zloirock/core-js#ecmascript-typed-arrays), many other features, [ECMAScript proposals](https://github.com/zloirock/core-js#ecmascript-proposals), [some cross-platform WHATWG / W3C features and proposals](#web-standards) like [`URL`](https://github.com/zloirock/core-js#url-and-urlsearchparams). You can load only required features or use it without global namespace pollution.
 
 ## Raising funds
 
@@ -26,47 +25,71 @@
 
 ---
 
-[*Example of usage*](https://tinyurl.com/2aj9lkwf):
+[*Example of usage*](https://tinyurl.com/2mknex43):
 ```js
-import 'core-js/actual'; // <- at the top of your entry point
+import 'core-js/actual';
+
+Promise.resolve(42).then(it => console.log(it)); // => 42
+
+Array.from(new Set([1, 2, 3]).union(new Set([3, 4, 5]))); // => [1, 2, 3, 4, 5]
 
-Array.from(new Set([1, 2, 3, 2, 1]));          // => [1, 2, 3]
-[1, 2, 3, 4, 5].group(it => it % 2);           // => { 1: [1, 3, 5], 0: [2, 4] }
-Promise.resolve(42).then(x => console.log(x)); // => 42
-structuredClone(new Set([1, 2, 3]));           // => new Set([1, 2, 3])
-queueMicrotask(() => console.log('called as microtask'));
+[1, 2].flatMap(it => [it, it]); // => [1, 1, 2, 2]
+
+(function * (i) { while (true) yield i++; })(1)
+  .drop(1).take(5)
+  .filter(it => it % 2)
+  .map(it => it ** 2)
+  .toArray(); // => [9, 25]
+
+structuredClone(new Set([1, 2, 3])); // => new Set([1, 2, 3])
 ```
 
 *You can load only required features*:
 ```js
-import 'core-js/actual/array/from';       // <- at the top of your entry point
-import 'core-js/actual/array/group';      // <- at the top of your entry point
-import 'core-js/actual/set';              // <- at the top of your entry point
-import 'core-js/actual/promise';          // <- at the top of your entry point
-import 'core-js/actual/structured-clone'; // <- at the top of your entry point
-import 'core-js/actual/queue-microtask';  // <- at the top of your entry point
-
-Array.from(new Set([1, 2, 3, 2, 1]));          // => [1, 2, 3]
-[1, 2, 3, 4, 5].group(it => it % 2);           // => { 1: [1, 3, 5], 0: [2, 4] }
-Promise.resolve(42).then(x => console.log(x)); // => 42
-structuredClone(new Set([1, 2, 3]));           // => new Set([1, 2, 3])
-queueMicrotask(() => console.log('called as microtask'));
+import 'core-js/actual/promise';
+import 'core-js/actual/set';
+import 'core-js/actual/iterator';
+import 'core-js/actual/array/from';
+import 'core-js/actual/array/flat-map';
+import 'core-js/actual/structured-clone';
+
+Promise.resolve(42).then(it => console.log(it)); // => 42
+
+Array.from(new Set([1, 2, 3]).union(new Set([3, 4, 5]))); // => [1, 2, 3, 4, 5]
+
+[1, 2].flatMap(it => [it, it]); // => [1, 1, 2, 2]
+
+(function * (i) { while (true) yield i++; })(1)
+  .drop(1).take(5)
+  .filter(it => it % 2)
+  .map(it => it ** 2)
+  .toArray(); // => [9, 25]
+
+structuredClone(new Set([1, 2, 3])); // => new Set([1, 2, 3])
 ```
 
 *Or use it without global namespace pollution*:
 ```js
-import from from 'core-js-pure/actual/array/from';
-import group from 'core-js-pure/actual/array/group';
-import Set from 'core-js-pure/actual/set';
 import Promise from 'core-js-pure/actual/promise';
+import Set from 'core-js-pure/actual/set';
+import Iterator from 'core-js-pure/actual/iterator';
+import from from 'core-js-pure/actual/array/from';
+import flatMap from 'core-js-pure/actual/array/flat-map';
 import structuredClone from 'core-js-pure/actual/structured-clone';
-import queueMicrotask from 'core-js-pure/actual/queue-microtask';
 
-from(new Set([1, 2, 3, 2, 1]));                // => [1, 2, 3]
-group([1, 2, 3, 4, 5], it => it % 2);          // => { 1: [1, 3, 5], 0: [2, 4] }
-Promise.resolve(42).then(x => console.log(x)); // => 42
-structuredClone(new Set([1, 2, 3]));           // => new Set([1, 2, 3])
-queueMicrotask(() => console.log('called as microtask'));
+Promise.resolve(42).then(it => console.log(it)); // => 42
+
+from(new Set([1, 2, 3]).union(new Set([3, 4, 5]))); // => [1, 2, 3, 4, 5]
+
+flatMap([1, 2], it => [it, it]); // => [1, 1, 2, 2]
+
+Iterator.from(function * (i) { while (true) yield i++; }(1))
+  .drop(1).take(5)
+  .filter(it => it % 2)
+  .map(it => it ** 2)
+  .toArray(); // => [9, 25]
+
+structuredClone(new Set([1, 2, 3])); // => new Set([1, 2, 3])
 ```
 
 **It's a bundled global version, for more info see [`core-js` documentation](https://github.com/zloirock/core-js/blob/master/README.md).**