<img height="1" width="1" style="display:none" src="https://www.facebook.com/tr?id=1063935717132479&amp;ev=PageView&amp;noscript=1 https://www.facebook.com/tr?id=1063935717132479&amp;ev=PageView&amp;noscript=1 "> Bitovi Blog - UX and UI design, JavaScript and Frontend development

Angular |

How to Support IE11 Users as You Move to Angular 13

IE 11 won't be supported in Angular 13. You can support it in 12 while you migrate to 13, or drop support. Either way, you need to act.

Mark Thompson

Mark Thompson

Twitter Reddit

Internet Explorer 11 is a legacy browser and support for it in Angular 13 is being dropped officially. Sticking with Angular 12 is not a viable long term option. Here are ways to support your users when upgrading your Angular version.

As an Angular developer, you want to provide support for as many browsers as you can, but in the case of Internet Explorer 11, this is becoming increasingly difficult, and soon will no longer be possible. Current market share is likely less than 1% and will drop even more as Microsoft retires IE 11 in June 2022

Even more challenging is that Angular 12 doesn't offer support for IE 11 by default, and Angular 13, coming out next week, is completely dropping support

Screen Shot 2021-10-27 at 3.13.41 PM

Choose a Support Path

There are two ways you can support IE 11 with Angular 12 as you prepare to migrate to Angular 13:
  • Update tsconfig.json to use ES5 and update polyfills.ts for ES6/ES7 
  • Use Differential Loading

Or you could decide to drop support for IE 11.  You should customize the user experience because if you don't, users will get a blank screen.

Update tsconfig.json and populate polyfills

By default, Angular compiles ES6 or ES7. IE 11 only supports ES5. You can update your tsconfig.json to target ES5. You'll also need to populate your Angular project polyfills.

Advantages of updating tsconfig.json and including polyfills:

  • Configuration prepares building and local development for IE 11 support
  • Faster builds than using Differential Loading


  • Imports a lot of polyfills and bloat bundle for legacy AND modern browsers
  • This approach has been abandoned as a standard after Angular 7


You'll change the target variable in tsconfig.json, and populate the polyfills file that came with the Angular project. If you're not familiar with these things, here's what they are.

target: JavaScript language version for emitted JavaScript.

Angular polyfills are fallbacks for missing JavaScript behavior. There are two types:
  • Browser polyfills that are applied before loading ZoneJS.
  • Application imports that are files imported after ZoneJS that should be loaded before your main file.

Polyfills are applied in this order: Browser polyfills -> Import ZoneJS -> Application imports. You will only need to focus on browser polyfills.

The Steps

1. Open tsconfig.json and update target to es5.

Screen Shot 2021-10-27 at 3.21.31 PM

2. Open polyfills.js found in the src directory and add import 'core-js'; under browser polyfills.

Screen Shot 2021-10-27 at 3.45.51 PM

NOTE: When serving the application, the build was at 505.3 kB. After adding the import of core-js,  it's 1.2 MB. 😬

Use Differential Loading

Differential Loading is the more modern technique introduced in Angular 8. The approach here is  to make two builds. One uses ES5 syntax and a more modern one that uses ES6 syntax. The ES6 build won't include as many polyfills and  going to be much smaller. The ES5 build will have polyfills and be more bloated. 


Advantages of using differential loading:

  • Smaller bundle sizes for modern browsers
  • ES5 bundle includes all required polyfills for legacy browser support automatically
  • Latest approach to supporting legacy browsers


  • Creates two bundles so longer build times
  • Extra configuration is required for local development for legacy browsers

The Steps

1. Find your browser's list file. Depending on the version of Angular, it will be .browserslistrc or browserslist

2. Remove the word "not" from the IE 11 line.

Screen Shot 2021-10-27 at 4.07.11 PM

Before I continue, I'll explain what just happened.

After you changed the browser's list file, when you look at your Angular project through Inspector, you'll see three additional scripts. Here's what it looked like before:

Screen Shot 2021-10-27 at 4.17.33 PM

And after:

Screen Shot 2021-10-27 at 4.17.53 PM

You will have two run times, two polyfills, and two mains. Modern browsers will only run the top script that is of type module. Legacy browsers like IE 11 will run the second one, the nomodule.

Screen Shot 2021-10-27 at 5.13.49 PM

NOTE: The rest of these steps are only needed if you want to run the project locally in development mode if you only use differential loading. 

3. Next up, you're going to create two new custom files in your application, a polyfills.es5.js in the src directory and tsconfig.es5.json at the root of your project.

4. Next steps are what you did for older tsconfig.json method above. Populate the polyfills file with your import. Then switch the tsconfig target to ES5 and to include your new polyfills file.

Screen Shot 2021-10-27 at 5.21.32 PM

5. Now you're going to update angular.json.

Screen Shot 2021-10-28 at 8.39.24 AM

Add a new build configuration. You can see on line 72 that I've added development-es5, where I copied all of the properties for development, and added two extra ones:

"tsConfig": "tsconfig.es5.json",

"polyfills": "src/polyfills.es5.ts"

6. To use this build when you serve locally, you need to add this new build configuration to the serve configurations. 

Screen Shot 2021-10-28 at 8.42.13 AM

As I did starting at line 94 above, use the same identifier, development-es5, and set browserTarget to "handling-ie:build:development-es5". Now you can serve your project for IE 11 using ng serve --configuration development-es5.


Why You Shouldn't Just Drop Support

You could drop support for IE 11. If you do, here's what an IE 11 user will see:

Screen Shot 2021-10-27 at 2.32.32 PM

Not a good user experience. Instead, we can change a few things to let our visitor know that they need a different browser.

How to Customize User Experience for IE 11

You don't want IE 11 users to see a white page. Instead, you can warn them about their browser or tell them to do something. Instead, you can use the same approach as you did with Differential Loading. Set a flag and take advantage of that flag to write specific code for legacy browsers.

Screen Shot 2021-10-28 at 8.52.24 AM

So you can call a no-es6.js script that will only run for legacy browsers by using the nomodule attribute.

Screen Shot 2021-10-28 at 9.01.30 AM

In this script, I set a property, nomodule, to true on window. Throughout my application, I can check for that value and I can see whether or not you are using IE.

Screen Shot 2021-10-28 at 9.04.49 AM

Note that nomodule is a custom property. That's not something that window has. Create a window.d.ts  in the src directory and add that property to global.

Screen Shot 2021-10-28 at 9.07.56 AM

How to Drop Support for IE 11 the Good Way

Finally, there will probably come a time when you offer no support for IE 11 and you've turned off differential loading or whatever you were using. How do you still provide a good user experience?

You can update your browser's list to say not IE, but your users will see a blank page.

Screen Shot 2021-10-28 at 9.17.31 AM

Instead, you can update the no-es6.js script.

Screen Shot 2021-10-28 at 9.18.48 AM

You can do all sorts of things here. In my example, I check for iIE. If I think you’re using IE, I’m going to try to use the microsoft-edge handler and open Edge to navigate the site. On IE, I’ll navigate you to a Microsoft support page that explains that IE is dropping support soon. If you're not using IE, I navigate you to a generic "hey, your browser is bad"page.

What Will You Do?

To sum it all up, there are two main ways to support IE 11. You can update your tsconfig.json, or you can use Differential Loading.

And you can provide a better user experience when you are dropping support and you can also provide a better user experience when you fully drop support. It's definitely time to decide what you'll do. 

What do you think you'll do? Have these methods been helpful? Do you have other techniques for managing IE 11 and Angular 13? We'd love to know your thoughts. Drop us a note in the comments section below.