backoff-promise v1.0.0

backoff-promise

An exponential backoff for promises

Example 1

var i = 0,
  Backoff = require('backoff-promise'),
  backoff = new Backoff();

var myPromise = function () {
  return new Promise(function (resolve, reject) {
    if (i++ < 5) {
      reject(new Error('transient-error'));
    } else {
      resolve('foo');
    }
  });
};

return backoff.run(function () {
  return myPromise();
});

Example 2: Different types of errors

var i = 0,
  Backoff = require('backoff-promise'),
  backoff = new Backoff();

var myPromise = function () {
  return new Promise(function (resolve, reject) {
    if (i++ < 3) {
      reject(new Error('transient-error'));
    } else {
      reject(new Error('permanent-error'));
    }
  });
};

var shouldRetry = function (err) {
  // Permanent error? If so, then stop retrying
  if (err.message === 'permanent-error') {
    throw err;
  }
};

return backoff.run(function () {
  return myPromise();
}, shouldRetry).catch(function (err) {
  // err.message = 'transient-error'
});

API

var backoff = Backoff(startingRetryAfterMSecs, maxRetryAfterMSecs, backoffFactor, maxRetries)