babel-plugin-remove-ungap v1.2.0
babel-plugin-remove-ungap
Remove @ungap ponyfills
Install babel-plugin-remove-ungap
npm i -D babel-plugin-remove-ungapUsage
Add remove-ungap to your babelrc plugins if the ponyfills are not needed by your
browser target. This could be due to only targeting modern browsers or because
your project already polyfills the browser.
This plugin works with CJS and ES modules before bundling. It can be run by
rollup-plugin-babel before import or require statements are altered.
exclude option
You can add the exclude option to block removal/processing of specific @ungap modules.
{
plugins: [
['remove-ungap', {
exclude: [
'@ungap/essential-map'
]
}]
]
}This config will cause any import of @ungap/essential-map to be preserved.
future option
Some @ungap polyfills are needed by most current browsers or did not exist when the
current semver-major of this plugin was released. These are only processed if explicitly
requested by the future option. For example:
{
plugins: [
['remove-ungap', {
future: [
'@ungap/from-entries'
]
}]
]
}Unknown modules are ignored.
Modules that are removed
| Module | Target | Declares variable |
|---|---|---|
| @ungap/assign | Object.assign | Yes |
| @ungap/array-iterator | Array.prototypeSymbol.iterator | Yes |
| @ungap/custom-event | CustomEvent | |
| @ungap/essential-map | Map | |
| @ungap/essential-set | Set | |
| @ungap/essential-symbol | Symbol | |
| @ungap/essential-weakset | WeakSet | |
| @ungap/event | Event | |
| @ungap/event-target | EventTarget | |
| @ungap/import-node | document.importNode | Yes |
| @ungap/is-array | Array.isArray | Yes |
| @ungap/map | Map | |
| @ungap/set | Set | |
| @ungap/template-literal | val => val | Yes |
| @ungap/trim | String.prototype.trim | Yes |
| @ungap/weakmap | WeakMap | |
| @ungap/weakset | WeakSet |
@ungap/create-content is altered
@ungap/create-content is altered so that
HAS_CONTENT is constant true. This allows minifiers to strip code that is not useed
by modern browsers.
Modules that can be removed by the future option
| Module | Target | Declares variable |
|---|---|---|
| @ungap/from-entries | Object.fromEntries | Yes |
| @ungap/global-this | globalThis | |
| @ungap/promise-all-settled | Promise.allSettled | Yes |
| @ungap/promise-any | Promise.any | Yes |
| @ungap/template-tag-arguments | (...args) => args | Yes |
Running tests
Tests are provided by xo and ava.
npm install
npm test