Known issues with NPM modules

Known issues with NPM dependencies

Bugs / unexpected behavior (with workaround)

phantomjs-prebuilt

• PhantomJS (which runs our unit tests) has very poor support for ES5. For example, Array.find() will fail.
  workaround: include a polyfill in your test/index.ts entry file.

typescript

• Libraries that use the export = syntax for exporting don't work in Typescript
  workaround: add "allowSyntheticDefaultImports": true to your tsconfig.json and import your libary using the syntax import * as name from 'some-npm-module'

sinon

Sinon is not in our boilerplate by default but we will often include it for detecting function calls in unit tests.

• Sinon does not work well with webpack workaround: use the sinon 2.0.0 prerelease

Bugs / unexpected behavior (no workaround yet)

(nothing here yet)

Other tips/tricks

(nothing here yet)