Next.js: Polyfill documentation

Created on 9 Jun 2018 · 8Comments · Source: vercel/next.js

Feature request

Is your feature request related to a problem? Please describe.

Currently there is no clear guidelines on implementing polyfils for browsers. There exists examples to polyfill with core-js although there also exists examples to use .babelrc with the env preset to support older browsers.

There is allot of confusion and issues around this topic.

Describe the solution you'd like

A clear section in the documentation that describes using .babelrc and the env preset to polyfill older browsers.

Additional context

We (ethical-jobs) would be happy to write up a PR / example to address this issue if people think its needed.

Source

andrewmclagan

❤3

Most helpful comment

btw. this is false claim this is fixed: https://github.com/zeit/next.js/issues/5783

Polyfills on native objects like [].includes() are not handled by current setup

sheerun on 17 Dec 2018

👍2

All 8 comments

So to explain:
Next.js supports ie11 and all modern browsers out of the box without polyfills.

The only time you'd need a polyfill is when you are pulling in an external dependency which is using methods that should be polyfilled in ie11/etc, this is what the with-polyfill example shows. So basically we'd have to document that specific part. I'd be super happy to take in a PR with documentation around this if you're willing to write it up 🙏