node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



Extending ES6 promises...

Some Context

Jake Archibald released a great polyfill of ES6 Promises that I've been trying to migrate towards using:

When contrasted with something like Q (, ES6 Promises lacks a lot of the bells and whistles that Q has built up. This project serves as a place to extend ES6 promises with some of those bells and whistles.


npm install myword


This method provides a simple means for one to extend the Promise prototype

  var Promise = require('myword');
  // mixin the ability to add a delay to your promise chain (don't ask me why you would do that...) 
    delay: function(milliseconds) {
      return function(result) {
        return new Promise(function(resolve, reject) {
          setTimeout(function() {
          }, milliseconds);
  // assuming getSomething() returns a promise and doSomething() does something with the result 


This method converts existing node-style functions that take callbacks into ones that return a Promise

var Promise = require('myword');
 * where callback is of the signature function(err, result)
var typicalNodeMethod = function(name, callback) {
  callback("Hello, " + name + "!");
var promiseMethod = Promise.promisify(typicalNodeMethod);


This method will be invoked when a promise is resolved or rejected. Function will be resolved with the resolved result or the error from being rejected.


This method will flatten (or spread) a promise result that is an array into individual function parameters

var Promise = require('myword');
// return a promise to resolve with a user (typically via an async db call or something) 
var getUser = function(name) {
  return Promise.resolve({name: name});
Promise.all([getUser("James"), getUser("Lindsay"), 2007])
  .spread(function(husband, wife, year) {
    console.log( + " married " + + " in " + year);

In contrast, normally by using promise.then() you would code the following:

Promise.all([getUser("James"), getUser("Lindsay"), 2007])
  .then(function(result) {
    console.log(result[0].name + " married " + result[1].name + " in " + result[2]);