5abf040b42 | ||
---|---|---|
.. | ||
LICENSE | ||
README.md | ||
ie9.js | ||
ie11.js | ||
jsdom.js | ||
package.json | ||
stable.js |
README.md
react-app-polyfill
This package includes polyfills for various browsers. It includes minimum requirements and commonly used language features used by Create React App projects.
Usage
First, install the package using Yarn or npm:
npm install react-app-polyfill
or
yarn add react-app-polyfill
Supporting Internet Explorer
You can import the entry point for the minimal version you intend to support to ensure that the minimum language features are present that are required to use Create React App. For example, if you import the IE9 entry point, this will include IE10 and IE11 support.
These modules ensure the following language features are present:
Promise
(forasync
/await
support)window.fetch
(a Promise-based way to make web requests in the browser)Object.assign
(a helper required for Object Spread, i.e.{ ...a, ...b }
)Symbol
(a built-in object used byfor...of
syntax and friends)Array.from
(a built-in static method used by array spread, i.e.[...arr]
)
If you need more features, see the Polyfilling other language features section below.
Internet Explorer 9
// This must be the first line in src/index.js
import 'react-app-polyfill/ie9';
// ...
Internet Explorer 11
// This must be the first line in src/index.js
import 'react-app-polyfill/ie11';
// ...
Polyfilling other language features
You can also polyfill stable language features not available in your target browsers. If you're using this in Create React App, it will automatically use the browserslist
you've defined to only include polyfills needed by your target browsers when importing the stable
polyfill. Make sure to follow the Internet Explorer steps above if you need to support Internet Explorer in your application.
// This must be the first line in src/index.js
import 'react-app-polyfill/stable';
// ...
If you are supporting Internet Explorer 9 or Internet Explorer 11 you should include both the ie9
or ie11
and stable
modules:
For IE9:
// These must be the first lines in src/index.js
import 'react-app-polyfill/ie9';
import 'react-app-polyfill/stable';
// ...
For IE11:
// These must be the first lines in src/index.js
import 'react-app-polyfill/ie11';
import 'react-app-polyfill/stable';
// ...