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

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).