Laravel Mix Polyfill
A Laravel Mix extension to include polyfills by using Babel, core-js, and regenerator-runtime.
Usage
First, install the extension.
npm install laravel-mix-polyfill --save-dev
or
yarn add laravel-mix-polyfill --dev
Then, require it within your webpack.mix.js
file:
let mix = require('laravel-mix');
require('laravel-mix-polyfill');
mix.js('resources/js/app.js', 'public/js')
.sass('resources/sass/app.scss', 'public/css')
.polyfill({
enabled: true,
useBuiltIns: "usage",
targets: "firefox 50, IE 11"
});
Options
Name | Type | Default | Description |
---|
enabled | boolean | true | Should polyfill be used. |
useBuiltIns | string | "usage" | See here for detailed description. Possible values are: • "usage" • "entry" • false |
targets | string , boolean | "defaults" | Allows a target (browser) environment to be specified. This can either be: • a browserslist-compatible query ("> 0.25%, not dead" ), • or false to transform all ECMAScript 2015+ code by default.
• Setting to false will also allow use of browserslist config sources (like .browserslistrc). See here and here for more information.
You can test string values on browserl.ist. |
entryPoints | string , boolean | "stable" | Used when useBuiltIns is set to "entry" . See below for possible values. |
corejs | number | 3 | The version of core-js to be used. |
debug | boolean | false | Outputs the targets/plugins used to the console. |
Entry Points
In core-js@3
the entry points were changed to allow for more flexibility.
The following common presets have been included for ease, and will be inserted into the entry point for you automatically. "stable"
has been set as the default as it is a full equal of the now deprecated @babel/polyfill
package which was used previously.
Value | Description |
---|
"stable" | Polyfill only stable core-js features - ES and web standards. |
"all" | Polyfill all core-js features. |
"es" | Polyfill only stable ES features. |
"classic" | Imports copied from the latest @babel/polyfill package (before it was deprecated). |
false | Do not use a preset (you will need to add your own imports to the top of your entry point). |