Configuring Browser Support

The official Nx plugins rely on browserslist for configuring application browser support. This affects builds, both production and development, and will decide on which transformations will be run on the code when built.

In general, the more modern your applications browser support is, the smaller the filesize as the code can rely on modern API's being present and not have to ship polyfills or shimmed code.

By default, applications generated from official Nx generators ship an aggressively modern browser support config, in the form of a .browserlistrc file in the root of the application with the following contents.

last 1 Chrome version last 1 Firefox version last 2 Edge major versions last 2 Safari major version last 2 iOS major versions Firefox ESR not IE 9-11 # For IE 9-11 support, remove 'not'.

This configuration is used for many tools including babel, autoprefixer, postcss, and more to decide which transforms are necessary on the source code when producing built code to run in the browser.

Adding Support for IE 11

Adding support for IE or any other browser is as easy as changing the .browserlistrc file, following the rules and options listed on the browserslist documentation. These changes will affect differential loading and how the code is processed through babel and other tools for producing your builds.

To add support for IE 11 simply change the final line in the .browserlistrc file to include IE:

last 1 Chrome version last 1 Firefox version last 2 Edge major versions last 2 Safari major version last 2 iOS major versions Firefox ESR IE 11

For additional information regarding the format and rule options, please see: https://github.com/browserslist/browserslist#queries

Debugging Browser Support

Sometimes broad configurations like > 0.5%, not IE 11 can lead to surprising results, due to supporting browsers like Opera Mini or Android UC browser.

To see what browsers your configuration is supporting, run npx browserslist in application directory to get an output of browsers and versions to support.

1$ npx browserslist
2and_chr 61
3chrome 83
4edge 83
5edge 81
6firefox 78
7firefox 68
8ie 11
9ios_saf 13.4-13.5
10ios_saf 13.3
11ios_saf 13.2
12ios_saf 13.0-13.1
13ios_saf 12.2-12.4
14ios_saf 12.0-12.1
15safari 13.1
16safari 13
17safari 12.1
18safari 12

Alternatively, if your support config is short you can just add it as a string param on the CLI:

1npx browserslist '> 0.5%, not IE 11'