2017-02-22 13:09:39 -05:00
|
|
|
@title
|
|
|
|
Browser support
|
|
|
|
|
|
|
|
@intro
|
|
|
|
Browser support and polyfills guide.
|
|
|
|
|
|
|
|
@description
|
2017-03-27 11:08:53 -04:00
|
|
|
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
Angular supports most recent browsers. This includes the following specific versions:
|
|
|
|
|
2017-03-30 15:04:18 -04:00
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
<table>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
|
|
<th>
|
|
|
|
Chrome
|
|
|
|
</th>
|
|
|
|
|
|
|
|
<th>
|
|
|
|
Firefox
|
|
|
|
</th>
|
|
|
|
|
|
|
|
<th>
|
|
|
|
Edge
|
|
|
|
</th>
|
|
|
|
|
|
|
|
<th>
|
|
|
|
IE
|
|
|
|
</th>
|
|
|
|
|
|
|
|
<th>
|
|
|
|
Safari
|
|
|
|
</th>
|
|
|
|
|
|
|
|
<th>
|
|
|
|
iOS
|
|
|
|
</th>
|
|
|
|
|
|
|
|
<th>
|
|
|
|
Android
|
|
|
|
</th>
|
|
|
|
|
|
|
|
<th>
|
|
|
|
IE mobile
|
|
|
|
</th>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
latest
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
latest
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
14
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
11
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
10
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
10
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
Marshmallow (6.0)
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
11
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
13
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
10
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
9
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
9
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
Lollipop<br>(5.0, 5.1)
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
9
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
8
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
8
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
KitKat<br>(4.4)
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
7
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
7
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
Jelly Bean<br>(4.1, 4.2, 4.3)
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
</table>
|
|
|
|
|
|
|
|
|
2017-03-27 11:08:53 -04:00
|
|
|
|
|
|
|
~~~ {.l-sub-section}
|
|
|
|
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
Angular's continuous integration process runs unit tests of the framework on all of these browsers for every pull request,
|
|
|
|
using <a href="https://saucelabs.com/" target="_blank">SauceLabs</a> and
|
|
|
|
<a href="https://www.browserstack.com" target="_blank">Browserstack</a>.
|
2017-03-27 11:08:53 -04:00
|
|
|
|
|
|
|
|
|
|
|
~~~
|
|
|
|
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
## Polyfills #
|
|
|
|
Angular is built on the latest standards of the web platform.
|
|
|
|
Targeting such a wide range of browsers is challenging because they do not support all features of modern browsers.
|
|
|
|
|
2017-03-11 08:44:25 -05:00
|
|
|
You can compensate by loading polyfill scripts ("polyfills") on the host web page (`index.html`)
|
2017-02-22 13:09:39 -05:00
|
|
|
that implement missing features in JavaScript.
|
|
|
|
|
2017-03-31 19:57:13 -04:00
|
|
|
<code-example path="quickstart/src/index.html" region="polyfills" title="quickstart/src/index.html" linenums="false">
|
2017-03-27 11:08:53 -04:00
|
|
|
|
|
|
|
</code-example>
|
2017-02-22 13:09:39 -05:00
|
|
|
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
A particular browser may require at least one polyfill to run _any_ Angular application.
|
|
|
|
You may need additional polyfills for specific features.
|
|
|
|
|
2017-03-11 08:44:25 -05:00
|
|
|
The tables below can help you determine which polyfills to load, depending on the browsers you target and the features you use.
|
2017-02-22 13:09:39 -05:00
|
|
|
|
|
|
|
|
|
|
|
~~~ {.alert.is-important}
|
|
|
|
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
2017-03-11 08:44:25 -05:00
|
|
|
The suggested polyfills are the ones that run full Angular applications.
|
2017-02-22 13:09:39 -05:00
|
|
|
You may need additional polyfills to support features not covered by this list.
|
|
|
|
Note that polyfills cannot magically transform an old, slow browser into a modern, fast one.
|
|
|
|
|
|
|
|
|
|
|
|
~~~
|
|
|
|
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
### Mandatory polyfills ##
|
|
|
|
These are the polyfills required to run an Angular application on each supported browser:
|
|
|
|
|
2017-03-30 15:04:18 -04:00
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
<table>
|
|
|
|
|
|
|
|
<tr style="vertical-align: top">
|
2017-03-31 19:57:13 -04:00
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
<th>
|
|
|
|
Browsers (desktop & mobile)
|
|
|
|
</th>
|
|
|
|
|
|
|
|
<th>
|
|
|
|
Polyfills required
|
|
|
|
</th>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr style="vertical-align: top">
|
2017-03-31 19:57:13 -04:00
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
<td>
|
|
|
|
Chrome, Firefox, Edge, Safari 9+
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
None
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr style="vertical-align: top">
|
2017-03-31 19:57:13 -04:00
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
<td>
|
|
|
|
Safari 7 & 8, IE10 & 11, Android 4.1+
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
2017-03-11 10:36:40 -05:00
|
|
|
[ES6](guide/browser-support#core-es6)
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr style="vertical-align: top">
|
2017-03-31 19:57:13 -04:00
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
<td>
|
|
|
|
IE9
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
|
|
|
[ES6<br>classList](guide/browser-support#classlist)
|
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
</table>
|
|
|
|
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
### Optional browser features to polyfill ##
|
|
|
|
Some features of Angular may require additional polyfills.
|
|
|
|
|
|
|
|
For example, the animations library relies on the standard web animation API, which is only available in Chrome and Firefox today.
|
|
|
|
You'll need a polyfill to use animations in other browsers.
|
|
|
|
|
|
|
|
Here are the features which may require additional polyfills:
|
|
|
|
|
2017-03-30 15:04:18 -04:00
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
<table>
|
|
|
|
|
|
|
|
<tr style="vertical-align: top">
|
2017-03-31 19:57:13 -04:00
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
<th>
|
|
|
|
Feature
|
|
|
|
</th>
|
|
|
|
|
|
|
|
<th>
|
|
|
|
Polyfill
|
|
|
|
</th>
|
|
|
|
|
|
|
|
<th style="width: 50%">
|
|
|
|
Browsers (desktop & mobile)
|
|
|
|
</th>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr style="vertical-align: top">
|
2017-03-31 19:57:13 -04:00
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
<a href="./animations.html">Animations</a>
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
2017-03-11 10:36:40 -05:00
|
|
|
[Web Animations](guide/browser-support#web-animations)
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
All but Chrome and Firefox<br>Not supported in IE9
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr style="vertical-align: top">
|
2017-03-31 19:57:13 -04:00
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
<a href="../api/common/index/DatePipe-pipe.html" target="_blank">Date</a> <span>, </span> <a href="../api/common/index/CurrencyPipe-pipe.html" target="_blank">currency</a> <span>, </span> <a href="../api/common/index/DecimalPipe-pipe.html" target="_blank">decimal</a> <span> and </span> <a href="../api/common/index/PercentPipe-pipe.html" target="_blank">percent</a> <span> pipes</span>
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
2017-03-11 10:36:40 -05:00
|
|
|
[Intl API](guide/browser-support#intl)
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
All but Chrome, Firefox, Edge, IE11 and Safari 10
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr style="vertical-align: top">
|
2017-03-31 19:57:13 -04:00
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
<a href="../api/common/index/NgClass-directive.html" target="_blank">NgClass</a> <span> on SVG elements</span>
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
|
|
|
[classList](guide/browser-support#classlist)
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
IE10, IE11
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr style="vertical-align: top">
|
2017-03-31 19:57:13 -04:00
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
<a href="./server-communication.html">Http</a> <span> when sending and receiving binary data</span>
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
|
|
|
[Typed Array](guide/browser-support#typedarray) <br>[Blob](guide/browser-support#blob)<br>[FormData](guide/browser-support#formdata)
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
IE 9
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
</table>
|
|
|
|
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
### Suggested polyfills ##
|
|
|
|
Below are the polyfills which are used to test the framework itself. They are a good starting point for an application.
|
|
|
|
|
2017-03-30 15:04:18 -04:00
|
|
|
|
2017-02-22 13:09:39 -05:00
|
|
|
<table>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
|
|
<th>
|
|
|
|
Polyfill
|
|
|
|
</th>
|
|
|
|
|
|
|
|
<th>
|
2017-03-11 08:44:25 -05:00
|
|
|
License
|
2017-02-22 13:09:39 -05:00
|
|
|
</th>
|
|
|
|
|
|
|
|
<th>
|
|
|
|
Size*
|
|
|
|
</th>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
<a id='core-es6' href="https://github.com/zloirock/core-js" target="_blank">ES6</a>
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
MIT
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
27.4KB
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
<a id='classlist' href="https://github.com/eligrey/classList.js" target="_blank">classList</a>
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
Public domain
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
1KB
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
<a id='intl' href="https://github.com/andyearnshaw/Intl.js" target="_blank">Intl</a>
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
2017-03-11 08:44:25 -05:00
|
|
|
MIT / Unicode license
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
13.5KB
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
<a id='web-animations' href="https://github.com/web-animations/web-animations-js" target="_blank">Web Animations</a>
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
Apache
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
14.8KB
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
<a id='typedarray' href="https://github.com/inexorabletash/polyfill/blob/master/typedarray.js" target="_blank">Typed Array</a>
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
MIT
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
4KB
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
<a id='blob' href="https://github.com/eligrey/Blob.js" target="_blank">Blob</a>
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
MIT
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
1.3KB
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
|
|
|
<td>
|
2017-03-31 19:57:13 -04:00
|
|
|
<a id='formdata' href="https://github.com/francois2metz/html5-formdata" target="_blank">FormData</a>
|
2017-02-22 13:09:39 -05:00
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
MIT
|
|
|
|
</td>
|
|
|
|
|
|
|
|
<td>
|
|
|
|
0.4KB
|
|
|
|
</td>
|
|
|
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
</table>
|
|
|
|
|
2017-03-31 19:57:13 -04:00
|
|
|
|
|
|
|
|
2017-03-11 08:44:25 -05:00
|
|
|
\* Figures are for minified and gzipped code,
|
|
|
|
computed with the <a href="http://closure-compiler.appspot.com/home" target="_blank">closure compiler</a>.
|