Angular2 why do we need the es6-shim

Question

Following the Angular2 Quickstart Guide we are instructed to include es6-shim in 2 places:

1) index.html

<script src="node_modules/es6-shim/es6-shim.min.js"></script>

2) typings.json

"ambientDependencies": {
  "es6-shim": "github:DefinitelyTyped/DefinitelyTyped/es6-shim/es6-shim.d.ts#6697d6f7dadbf5773cb40ecda35a76027e0783b2"
}

I was under the impression that we are compiling our es6 code down to es5.

Configured in tsconfig.json

{
  "compilerOptions": {
    "target": "es5",
    ...

If the end result is that the browser is loading es5, why does the browser needs shims for es6?

Answer 1

Typings are used by your editor to give you code hinting/intellisense, and es6-shim.min.js is a code that emulates ES6 features for ES5 browsers. Some of those features are Promise, Array.from()...

While your code is translated to ES5, you need to include es6-shim so you can use those new features in it... Consider this ES6 code:

let test1 = () => 123 + 456;
let test2 = new Promise((resolve, reject ) => {});

it will be translated to ES5 code:

var test1 = function () { return 123 + 456; };
var test2 = new Promise(function (resolve, reject) { });

but without es6-shim Promise would be undefined...