# ES6-Promises (subset of [rsvp.js](https://github.com/tildeio/rsvp.js)) This is a polyfill of [ES6 Promises](https://github.com/domenic/promises-unwrapping). The implementation is a subset of [rsvp.js](https://github.com/tildeio/rsvp.js), if you're wanting extra features and more debugging options, check out the [full library](https://github.com/tildeio/rsvp.js). For API details and how to use promises, see the JavaScript Promises HTML5Rocks article. ## Downloads * [promise](http://s3.amazonaws.com/es6-promises/promise-0.1.2.js) * [promise-min](http://s3.amazonaws.com/es6-promises/promise-0.1.2.min.js) (~2k gzipped) ## Node.js To install: ```sh npm install es6-promise ``` To use: ```js var Promise = require('es6-promise').Promise; ``` ## Usage in IE<10 `catch` is a reserved word in IE<10, meaning `promise.catch(func)` throws a syntax error. To work around this, to a string to access the property: ```js promise['catch'](function(err) { // ... }); ``` Or use `.then` instead: ```js promise.then(undefined, function(err) { // ... }); ``` ## Building & Testing This package uses the [grunt-microlib](https://github.com/thomasboyt/grunt-microlib) package for building. Custom tasks: * `grunt test` - Run Mocha tests through Node and PhantomJS. * `grunt test:phantom` - Run Mocha tests through PhantomJS (browser build). * `grunt test:node` - Run Mocha tests through Node (CommonJS build).