123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778 |
- # babel-plugin-polyfill-corejs3
- ## Install
- Using npm:
- ```sh
- npm install --save-dev babel-plugin-polyfill-corejs3
- ```
- or using yarn:
- ```sh
- yarn add babel-plugin-polyfill-corejs3 --dev
- ```
- ## Usage
- Add this plugin to your Babel configuration:
- ```json
- {
- "plugins": [["polyfill-corejs3", { "method": "usage-global", "version": "3.20" }]]
- }
- ```
- This package supports the `usage-pure`, `usage-global`, and `entry-global` methods.
- When `entry-global` is used, it replaces imports to `core-js`.
- ## Options
- See [here](../../docs/usage.md#options) for a list of options supported by every polyfill provider.
- ### `version`
- `string`, defaults to `"3.0"`.
- This option only has an effect when used alongside `"method": "usage-global"` or `"method": "usage-pure"`. It is recommended to specify the minor version you are using as `core-js@3.0` may not include polyfills for the latest features. If you are bundling an app, you can provide the version directly from your node modules:
- ```js
- {
- plugins: [
- ["polyfill-corejs3", {
- "method": "usage-pure",
- // use `core-js/package.json` if you are using `usage-global`
- "version": require("core-js-pure/package.json").version
- }]
- ]
- }
- ```
- If you are a library author, specify a reasonably modern `core-js` version in your
- `package.json` and provide the plugin the minimal supported version.
- ```json
- {
- "dependencies": {
- "core-js": "^3.20.0"
- }
- }
- ```
- ```js
- {
- plugins: [
- ["polyfill-corejs3", {
- "method": "usage-global",
- // improvise if you have more complicated version spec, e.g. > 3.1.4
- "version": require("./package.json").dependencies["core-js"]
- }]
- ]
- }
- ```
- ### `proposals`
- `boolean`, defaults to `false`.
- This option only has an effect when used alongside `"method": "usage-global"` or `"method": "usage-pure"`. When `proposals` are `true`, any ES proposal supported by core-js will be polyfilled as well.
|