Docs: polyfills and supported browsers

What is the improvement or update you wish to see?

Next.js supports modern browsers with zero configuration.

The NextJS documentation is very unclear about the browser support and how polyfills work. Reading it without understanding how they are applied makes you believe that there is no configuration needed for the mentioned browser list to be polyfilled and work.

We inject widely used polyfills, including:

The link in above goes to the next-polyfill-nomodule which adds the polyfills by noModule property in the script tag. The attribute is set to indicate that the script should not be executed in browsers that support ES modules

Is there any context that might help us understand?

With the current solution it means that no browser with support for ES modules will use the (nomodule) polyfill file. As an example chrome got support for ES modules in version 61, while it did not get support for Promise.allSettled until version 76, that means that any chrome version above 61 won't get polyfilled.

The documentation is at minimum very misleading and potentially can be considered a bug. It seems like the polyfills that are in the nomodules file were made for IE11.

Does the docs page already exist? Please link to it.

https://nextjs.org/docs/architecture/supported-browsers

Start with the supported browsers documentation at https://nextjs.org/docs/architecture/supported-browsers and inspect the linked packages/next-polyfill-nomodule/src/index.js. Verify how the noModule polyfill behavior relates to the browser list and ES module support. Done means the documentation clearly explains which browsers are supported, how polyfills are applied, and what configuration is required.