alien-node-q-utils

Helper functions for promises with Q on NodeJS. The functions are pure and curried with Ramda.

Install

$ npm install alien-node-q-utils --save

Run the specs

$ npm test

Methods

rejectedPromise

A pre-rejected promise that throws the rejection into an expected catch block.

it('should pre-reject a promise', function(done) {
  rejectedPromise('foo')
    .catch(function(err) {
      expect(err).toBe('foo');
      done();
    })
});

resolvedPromise

A pre-resolved promise that passes the resolution into the expected then block.

it('should pre-resolve a promise', function(done) {
  resolvedPromise('foo')
    .then(function(data) {
      expect(data).toBe('foo');
      done();
    })
});

rejectOnErrorOrResolve

Given a function signature of fn(deferred, err, data) this will reject deferred if err is provided, otherwise resolve deferred with data. - Don't forget this function is curried, so the arity must be recognized. (If you omit the data param, you will get a function that accepts only the data param.)

var mockPromiseNoError = function(resolveWith) {
  var deferred = Q.defer();
  rejectOnErrorOrResolve(deferred, undefined, resolveWith);
  return deferred.promise;
};

var mockPromiseWithError = function(err) {
  var deferred = Q.defer();
  rejectOnErrorOrResolve(deferred, err, undefined);
  return deferred.promise;
};

it('should resolve if no error is provided', function(done) {
  var deferred = Q.defer();
  mockPromiseNoError('foo')
    .then(function(data) {
      expect(data).toBe('foo');
      done();
    });
});

it('should reject if error is provided', function(done) {
  var deferred = Q.defer();
  mockPromiseWithError('foo')
    .catch(function(err) {
      expect(err).toBe('foo');
      done();
    });
});

TODO

- Need specs and descriptions for new mapP methods