In Focus

IE 11 Polyfill Package For SPFx

In this article, you will learn about IE 11 Polyfill Package for SPFx.

Overview

 
SharePoint Framework client-side web parts are developed using HTML, CSS, and JavaScript code. Microsoft claims SPFx to be compatible with all modern bowsers including mainly Google Chrome, IE Edge, and IE 11. SPFx web parts seem to be working well with all browsers except a few cases in IE11. From a long time, IE 11 has been a nightmare for developers. The code which runs fine on all browsers did not work as expected in IE 11 and we have been patching to make it work. SPFx development is also not an exception to this scenario.
 
In this article, we will explore common issues for SPFx with IE 11, the reasons behind it, and how SharePoint PnP (Patterns and Practices) has helped to overcome these issues.
 

What is IE 11 lacking?

 
Comparatively, IE 11 is an older browser. However, there is a significant user base still using IE 11 as a primary browser. Being an old browser, IE 11 lacks a few features like fetch, map, and proxy. During SPFx development we normally make use of these features and they fail to work in IE 11.
 

Polyfilling IE 11

 
There are lots of browsers and their versions available and each has different sets of features to offer. The latest browser supports most modern things, while older browser versions do not. However, we still have to support our applications on older browser versions. Polyfill makes it simpler to support all browser versions by recreating the missing features. Generally, Polyfill is a service which accepts request for a set of browser features and returns only missing functionality or polyfills that are needed for the requesting browser.
 
IE 11 does not support fetch, map, and proxy which is commonly used in SPFx development. SharePoint PnP has designed a polyfill package for IE 11 targeting SPFx support.
 

Create SPFx Web Part

 
Let us create a basic SPFx web part to display items from SharePoint list and use map function to render them.
 
Open a command prompt. Create a directory for SPFx solution.
  1. md pnp-polyfill-ie11
Navigate to the above-created directory.
  1. cd pnp-polyfill-ie11  
Run the Yeoman SharePoint Generator to create the solution.
  1. yo @microsoft/sharepoint  
Yeoman generator will present you with the wizard by asking questions about the solution to be created.
 
IE 11 Polyfill Package For SPFx
 
Solution Name: Hit Enter to have default name (pnp-polyfill-ie11 in this case) or type in any other name for your solution.
Selected choice: Hit enter
 
Target for the component: Here, we can select the target environment where we are planning to deploy the client web part, i.e., SharePoint Online or SharePoint OnPremise (SharePoint 2016 or 2019 onwards).
Selected choice: SharePoint Online only (latest)
 
Place of files: We may choose to use the same folder or create a subfolder for our solution.
Selected choice: Use the current folder
 
Deployment option: Selecting Y will allow the app to deployed instantly to all sites and will be accessible everywhere.
Selected choice: Y
 
Permissions to access web APIs: Choose if the components in the solution require permissions to access web APIs that are unique and not shared with other components in the tenant.
Selected choice: N (solution contains unique permissions)
 
Type of client-side component to create: We can choose to create a client-side web part or an extension.
Selected choice: WebPart
 
Web Part Name: Hit Enter to select the default name or type in any other name.
Selected choice: PnPPolyfill
 
Web part description: Hit enter to select the default description or type in any other value.
Selected choice: PnP Polyfill for IE11
 
Framework to use: Select any JavaScript framework to develop the component. Available choices are (No JavaScript Framework, React, and Knockout)
Selected choice: No JavaScript Framework
Once the scaffolding is completed, lock down the version of project dependencies by running below command.
  1. npm shrinkwrap  
On the command prompt, type the below command to open the solution in the code editor of your choice.
  1. code .  

Add @pnp/sp Package

 
We will include @pnp/sp to simplify common operations with SharePoint and SPFx. On the command prompt, type the below command to add @pnp/sp npm package to project.
  1. npm i @pnp/logging @pnp/common @pnp/odata @pnp/sp --save  

Code the WebPart

 
Let us create a basic SPFx web part to display items from SharePoint list and use map function to render them.
 
Open the main web part file at “src\webparts\pnPPolyfill\PnPPolyfillWebPart.ts”
 
Add the below import,
  1. // @pnp/sp imports    
  2. import { sp, Web } from '@pnp/sp';  
Update Render method as below to show items from a SharePoint list.
  1. public render(): void {  
  2.   sp.web.lists.getByTitle("KBArticles").items.filter(`ID gt 0`).get().then(r => {    
  3.     this.domElement.innerHTML += r.map(l => `${l.Title}<br />`);    
  4.   });  
  5. }  

Test SPFx Web Part

  1. On the command prompt, type “gulp serve”.
  2. Open SharePoint site.
  3. Navigate to /_layouts/15/workbench.aspx
  4. Add the web part to the page.
  5. Observe the web part in IE 11 and Google Chrome.
IE 11 Polyfill Package For SPFx
 
The web part displays list items in Google Chrome. However, it fails to render the same in IE 11. The reason is, we have used filter, map operations in our SPFx web part.
 

IE 11 Polyfill package

 
Polyfill package supports all browser versions by recreating the missing features. On the command prompt, run the below command to include the IE 11 Polyfill package.
  1. npm install --save @pnp/polyfill-ie11  

Import Polyfill to our class

 
Open main web part file at “src\webparts\pnPPolyfill\PnPPolyfillWebPart.ts”.
 
Add the below import,
  1. // IE 11 Polyfill import
  2. import "@pnp/polyfill-ie11";  
That’s it. We do not need to make any code level changes for IE 11. Let us try loading our web part in IE 11 again and it works now. 
 
IE 11 Polyfill Package For SPFx
 

Summary

 
In this article, we explored common issues for SPFx with IE 11, the reasons behind it and how SharePoint PnP (Patterns and Practices) has helped to overcome these issues by introducing IE 11 Polyfill package. The Polyfill package supports all browser versions by recreating the missing features. IE 11 is now a relatively old browser. However, we still need to support our applications on IE 11. Polyfill helps to fill in the gaps for missing functionalities in older browsers. PnP has provided IE 11 Polyfill package targeting SPFx support, which includes needed functionality without us having to determine which polyfills to add.