async-retry vs backoff vs exponential-backoff vs promise-retry vs retry
Implementing Resilient Retry Logic in JavaScript
Search packages..
async-retrybackoffexponential-backoffpromise-retryretrySimilar Packages:

Implementing Resilient Retry Logic in JavaScript

Transient failures are a fact of life in distributed systems and web applications. Network requests fail, databases lock, and APIs rate-limit. These five packages provide strategies to handle such failures by automatically retrying operations. They differ primarily in their age, programming model (callbacks vs promises), and configuration flexibility. Choosing the right one depends on whether you are working in a legacy callback environment or a modern async/await codebase, and how much control you need over the backoff strategy.

Npm Package Weekly Downloads Trend

3 Years

Github Stars Ranking

Stat Detail

Package
Downloads
Stars
Size
Issues
Publish
License
async-retry01,918-305 years agoMIT
backoff0336-1110 years agoMIT
exponential-backoff040555.2 kB68 months agoApache-2.0
promise-retry0320-116 years agoMIT
retry01,258-215 years agoMIT

Implementing Resilient Retry Logic in JavaScript

When building robust applications, handling transient failures is non-negotiable. Whether you are fetching data from an API or writing to a database, things will fail temporarily. The packages async-retry, backoff, exponential-backoff, promise-retry, and retry all solve this problem, but they approach it from different eras of JavaScript development. Let's compare how they handle execution, configuration, and errors.

🔄 Execution Model: Callbacks vs Promises

The biggest divide in this group is between older callback-based tools and modern promise-based ones. This dictates how they fit into your codebase.

retry is the original. It uses callbacks for both the operation and the completion.

const retry = require('retry');

const operation = retry.operation({ retries: 3 });

operation.attempt(function(currentAttempt) {
  fetchData(function(err, result) {
    if (operation.retry(err)) {
      return;
    }
    console.log(operation.mainError());
  });
});

backoff also relies on callbacks, focusing on the backoff strategy itself.

const backoff = require('backoff');

const fibBackoff = backoff.fibonacci();

fibBackoff.failAfter(3);

fibBackoff.on('backoff', function(number, delay) {
  // Try operation here after delay
});

fibBackoff.backoff();

promise-retry wraps the logic to return a promise, bridging the gap.

const promiseRetry = require('promise-retry');

promiseRetry(function(retry, number) {
  return fetchData()
    .catch(function(err) {
      if (retry.isError(err)) {
        throw err; // Triggers retry
      }
      throw err; // Fails immediately
    });
}, { retries: 3 })
.then(function(result) {
  console.log(result);
});

async-retry is built for async/await, offering the cleanest syntax for modern apps.

const retry = require('async-retry');

try {
  const result = await retry(async (bail, number) => {
    const res = await fetchData();
    if (res.status === 500) throw new Error('Server Error');
    return res;
  }, { retries: 3 });
  console.log(result);
} catch (err) {
  console.error(err);
}

exponential-backoff typically provides the delay logic, often used within a custom async loop.

import { backoff } from 'exponential-backoff';

await backoff(async () => {
  const res = await fetchData();
  if (!res.ok) throw new Error('Failed');
  return res;
}, {
  maxNumberOfRetries: 3,
});

⚙️ Configuration & Backoff Strategy

Controlling how long to wait between attempts is critical to avoid overwhelming services. Each package exposes these settings differently.

retry uses a timeouts array or factors to calculate delays.

const operation = retry.operation({
  retries: 3,
  factor: 2,
  minTimeout: 1000,
  maxTimeout: 5000
});

backoff lets you choose the strategy type (fibonacci, exponential) explicitly.

const exponentialBackoff = backoff.exponential({
  initialDelay: 1000,
  maxDelay: 5000
});

promise-retry passes options directly to the underlying retry logic.

promiseRetry(function(retry) {
  return fetchData();
}, {
  retries: 3,
  factor: 2,
  minTimeout: 1000
});

async-retry simplifies options to the most common needs.

await retry(async () => {
  return fetchData();
}, {
  retries: 3,
  factor: 2,
  minTimeout: 1000,
  randomize: true // Adds jitter
});

exponential-backoff focuses heavily on the delay math, often including jitter by default.

await backoff(async () => {
  return fetchData();
}, {
  maxNumberOfRetries: 3,
  startingDelay: 1000,
  timeMultiple: 2
});

🛑 Error Handling & Abort Control

Knowing when to stop retrying is as important as retrying itself. Some packages let you bail out early.

retry requires you to check operation.retry(err) manually to decide continuation.

if (err.code === 'ENOTFOUND') {
  operation.fail(err); // Stop immediately
  return;
}
if (operation.retry(err)) return;

backoff emits events you listen to, allowing logic inside the event handler.

fibBackoff.on('fail', function(err) {
  console.log('Stopped due to error', err);
});

promise-retry allows throwing specific errors to signal a hard failure.

.catch(function(err) {
  if (err.code === 'CRITICAL') {
    retry.cancel(); // Stop retries
  }
  throw err;
});

async-retry provides a bail function to stop retries immediately on non-retryable errors.

await retry(async (bail) => {
  const res = await fetchData();
  if (res.status === 404) {
    bail(new Error('Not Found')); // Stops retries
    return;
  }
  throw new Error('Retry me');
});

exponential-backoff usually relies on the promise rejection to stop, but some versions support abort signals.

const controller = new AbortController();

await backoff(async () => {
  if (someCondition) controller.abort();
  return fetchData();
}, {
  signal: controller.signal
});

📊 Summary Table

Featureretrybackoffpromise-retryasync-retryexponential-backoff
StyleCallbackCallbackPromiseAsync/AwaitAsync/Await
AgeLegacyLegacyMatureModernModern
Bail OutManual CheckEvent ListenerCancel Methodbail() FunctionAbort Signal
JitterrandomizeCustomInheritedrandomizeBuilt-in
Best ForLegacy NodeCustom Strategiesnpm ToolingFrontend/Next.jsCustom Loops

💡 The Big Picture

retry and backoff are the foundations. They are battle-tested but show their age with callback patterns. Use them only if you are maintaining older systems or need specific low-level control over the backoff algorithm itself.

promise-retry is the bridge. It is excellent for tooling and CLI apps where promises are needed but the retry logic is preferred. It is less common in frontend UI code.

async-retry is the frontend favorite. Its API is designed for modern JavaScript. The bail function is particularly useful for handling 4xx errors that should not be retried. It is the safest choice for React, Vue, or Next.js projects.

exponential-backoff is a specialist. Use it if you are writing your own retry logic and just need a robust delay calculator, or if you need specific jitter configurations not found in the others.

Final Thought: For most new frontend development, async-retry offers the best balance of simplicity and power. It removes the boilerplate of older libraries while providing the control needed for production-grade resilience.

How to Choose: async-retry vs backoff vs exponential-backoff vs promise-retry vs retry

  • async-retry:

    Choose async-retry for modern frontend or Node.js projects using async/await. It is lightweight, promise-native, and maintained by Vercel, making it a safe bet for React and Next.js ecosystems where concise syntax is valued.

  • backoff:

    Choose backoff if you need fine-grained control over the backoff strategy itself, separate from the retry logic. It is best suited for older Node.js services that rely on callback patterns and require custom exponential or fibonacci strategies.

  • exponential-backoff:

    Choose exponential-backoff when you need a dedicated implementation of exponential backoff with jitter support without the overhead of a full retry wrapper. It is ideal for scenarios where you are building your own retry loop but need a reliable delay calculator.

  • promise-retry:

    Choose promise-retry if you are working in an environment that already uses the retry package but needs promise support. It is commonly found in npm internals and tooling, making it a solid choice for build scripts or CLI tools.

  • retry:

    Choose retry only for maintaining legacy systems that rely on callback-based flows. It is the foundational package for many others but lacks native promise support, making it less suitable for new frontend development.

Similar Npm Packages to async-retry

async-retry is a utility library for retrying asynchronous functions in JavaScript. It provides a simple and flexible way to handle retries for operations that may fail intermittently, such as network requests or database operations. With async-retry, developers can easily specify the number of retries, delay between attempts, and conditions under which to retry, making it a powerful tool for improving the resilience of applications. However, there are several alternatives available that offer similar functionality. Here are a few noteworthy options:

  • p-retry is a promise-based retry utility that allows you to retry asynchronous functions with customizable options. It is designed to work seamlessly with promises, making it a great choice for modern JavaScript applications. p-retry provides a straightforward API for defining retry logic, including the number of retries, delay between attempts, and error handling. If you are looking for a lightweight and promise-centric solution for retrying asynchronous operations, p-retry is an excellent option.

  • promise-retry is another library that focuses on retrying promise-returning functions. It offers a simple API for defining retry logic, including options for maximum retries, delay, and exponential backoff. promise-retry is particularly useful for scenarios where you need to handle transient errors in asynchronous operations, such as API calls or database queries. If you prefer a library that emphasizes simplicity and ease of use, promise-retry is worth considering.

  • retry is a more general-purpose retry utility that can be used with both synchronous and asynchronous functions. It provides a flexible API for configuring retries, including options for maximum attempts, delay, and backoff strategies. retry is suitable for a wide range of use cases, making it a versatile choice for developers who need a robust retry mechanism. If you require a library that can handle both sync and async operations with customizable retry logic, retry is a solid option.

  • retry-axios is a specialized library designed to work with Axios, the popular HTTP client for JavaScript. It provides automatic retry functionality for failed HTTP requests, making it easy to handle transient errors in network communication. With retry-axios, you can configure retry options such as the number of attempts and delay between retries, all while leveraging the familiar Axios API. If you are using Axios for your HTTP requests and want to add retry capabilities, retry-axios is a great choice.

For a comprehensive comparison of these libraries, check out the link: Comparing async-retry vs p-retry vs promise-retry vs retry vs retry-axios.

Similar Npm Packages to backoff

backoff is a JavaScript library designed to implement exponential backoff strategies for retrying failed asynchronous operations. This is particularly useful in scenarios where you need to handle transient errors, such as network requests or API calls, that may succeed if retried after a certain delay. The backoff library provides a simple and flexible API to configure the retry strategy, including options for maximum retries, delay intervals, and jitter to avoid thundering herd problems.

While backoff is a solid choice for implementing retry logic, there are several alternatives available in the ecosystem that offer similar functionalities. Here are a few noteworthy options:

  • async-retry is a lightweight library that provides a simple way to retry asynchronous functions with customizable retry strategies. It allows you to specify the number of retries, delay intervals, and even a custom retry condition. async-retry is particularly useful for handling promises and can be easily integrated into existing asynchronous workflows, making it a great choice for developers looking for a straightforward retry mechanism.

  • exponential-backoff is a library that focuses specifically on implementing the exponential backoff algorithm. It provides a simple API to configure the backoff strategy, including options for maximum delay and jitter. This library is ideal for developers who want a dedicated solution for exponential backoff without additional features that may come with more comprehensive libraries.

  • promise-retry is another library that allows you to retry promise-returning functions with a customizable retry strategy. It supports both linear and exponential backoff strategies and provides options for maximum retries and delay intervals. promise-retry is a good choice for developers who want a straightforward way to handle retries for promises while maintaining control over the retry logic.

  • retry is a versatile library that provides a simple way to retry any function, including synchronous and asynchronous ones. It offers a variety of options for configuring the retry strategy, including exponential backoff, maximum retries, and delay intervals. retry is suitable for developers looking for a general-purpose retry mechanism that can handle both promise-based and callback-based functions.

To see how backoff compares with async-retry, exponential-backoff, promise-retry, and retry, check out the comparison: Comparing async-retry vs backoff vs exponential-backoff vs promise-retry vs retry.

Similar Npm Packages to exponential-backoff

exponential-backoff is a JavaScript library designed to implement the exponential backoff algorithm, which is commonly used in network communication and API calls to handle retries in a controlled manner. This approach gradually increases the wait time between retries after each failure, which helps to reduce the load on servers and improve the chances of successful requests over time. While exponential-backoff is a solid choice for managing retries, there are several alternatives available in the npm ecosystem. Here are a few noteworthy options:

  • async-retry is a simple and flexible library for retrying asynchronous functions. It allows developers to specify the number of retries, the delay between attempts, and even custom retry strategies. async-retry is particularly useful when you need to handle transient errors in network requests or other asynchronous operations, making it a great alternative to exponential-backoff for more complex retry scenarios.

  • backoff is another library that provides a robust implementation of the backoff algorithm, including exponential backoff. It allows you to create customizable backoff strategies with various options for delays and maximum attempts. backoff is suitable for applications that require fine-tuned control over the retry process and can be used for both synchronous and asynchronous operations.

  • p-retry is a promise-based retry library that simplifies the process of retrying failed asynchronous operations. It provides a straightforward API for specifying the number of retries and delay strategies, including exponential backoff. If you are working with promises and want a simple way to implement retries, p-retry is a great choice.

  • promise-retry is another library focused on retrying promise-returning functions. It allows you to define the number of retries, delay between attempts, and even custom retry conditions. This library is particularly useful for handling API calls and other asynchronous operations that may fail intermittently.

  • retry is a general-purpose retry library that can be used with both synchronous and asynchronous functions. It provides a flexible API for configuring retry attempts, delays, and strategies. If you need a versatile solution that can handle various types of operations, retry is worth considering.

To compare these libraries and see how they stack up against each other, check out the following link: Comparing async-retry vs backoff vs exponential-backoff vs p-retry vs promise-retry vs retry.

Similar Npm Packages to promise-retry

promise-retry is a utility library that allows developers to retry asynchronous operations that return promises. This can be particularly useful for handling transient errors in network requests or other operations that may fail intermittently. By providing a simple API to specify the number of retries and the delay between attempts, promise-retry helps ensure that applications can gracefully handle failures and improve their resilience.

While promise-retry is a solid choice for retrying promises, there are several alternatives in the JavaScript ecosystem that offer similar functionality. Here are a few noteworthy options:

  • async-retry is a library designed for retrying asynchronous functions with a simple and flexible API. It allows developers to specify the number of retries, delay between attempts, and even customize the retry logic based on the type of error encountered. async-retry is particularly useful for scenarios where you need more control over the retry behavior and want to handle different types of errors differently.

  • p-retry is another lightweight library that focuses on retrying promises. It provides a straightforward API that allows you to specify the number of retries, delay, and a predicate function to determine if the operation should be retried based on the error. p-retry is a great choice for developers looking for a simple and effective way to implement retry logic in their applications without additional overhead.

  • promise-poller is a utility for polling asynchronous operations until they succeed or a specified timeout is reached. While it is not strictly a retry library, it can be used to repeatedly check the status of an operation at specified intervals. This is especially useful for scenarios where you need to wait for a resource to become available or for a condition to be met.

  • retry is a more general-purpose library for retrying functions, not limited to promises. It provides a flexible way to specify retry strategies, including exponential backoff and custom error handling. This library is suitable for developers who want a more comprehensive solution for retrying both synchronous and asynchronous operations.

  • retry-axios is an Axios interceptor that automatically retries failed HTTP requests. It integrates seamlessly with Axios, allowing developers to specify retry logic directly in their HTTP client configuration. If you are using Axios for making HTTP requests and want built-in retry functionality, retry-axios is an excellent choice.

To see how promise-retry compares with async-retry, p-retry, promise-poller, retry, and retry-axios, check out the comparison: Comparing async-retry vs p-retry vs promise-poller vs promise-retry vs retry vs retry-axios.

Similar Npm Packages to retry

retry is a versatile npm package designed to provide a simple way to retry asynchronous operations in JavaScript. This can be particularly useful in scenarios where network requests or other operations may fail intermittently and need to be retried. The retry package allows developers to specify the number of attempts, delay between attempts, and other customizable options, making it a flexible solution for handling transient errors.

While retry is a solid choice, there are several alternatives in the ecosystem that offer similar functionality with different features and approaches. Here are a few noteworthy alternatives:

  • async-retry is a lightweight library that provides a simple way to retry asynchronous functions with customizable options. It supports exponential backoff and allows you to define the number of attempts and the delay between retries. async-retry is particularly useful for handling promises and works seamlessly with async/await syntax, making it a great choice for modern JavaScript applications.

  • backoff is a library that implements exponential backoff algorithms for retrying operations. It provides a more sophisticated approach to retries, allowing developers to define custom backoff strategies. This can be particularly useful in scenarios where you want to avoid overwhelming a server with repeated requests in a short period. backoff is suitable for applications that require fine-tuned control over retry behavior.

  • promise-retry is another library focused on retrying promise-based functions. It offers a straightforward API for retrying failed promises with customizable options for the number of retries and delay. promise-retry is a good choice for developers who want a simple and effective way to handle retries in promise-based workflows.

  • retry-axios is a specialized library that integrates the retry functionality directly with the Axios HTTP client. It allows you to automatically retry failed HTTP requests made with Axios, providing a seamless experience for handling transient network errors. If you are already using Axios in your application, retry-axios can be a great addition to enhance its resilience.

  • retry-request is a library that extends the functionality of the popular request library by adding retry capabilities. It allows you to specify retry options for HTTP requests, making it easier to handle transient errors when making network calls. If you are using the request library, retry-request can provide a straightforward way to add retry logic to your requests.

To compare these packages and see how they stack up against each other, check out the following link: Comparing async-retry vs backoff vs promise-retry vs retry vs retry-axios vs retry-request.

README for async-retry

async-retry

Retrying made simple, easy, and async.

Usage

// Packages
const retry = require('async-retry');
const fetch = require('node-fetch');

await retry(
  async (bail) => {
    // if anything throws, we retry
    const res = await fetch('https://google.com');

    if (403 === res.status) {
      // don't retry upon 403
      bail(new Error('Unauthorized'));
      return;
    }

    const data = await res.text();
    return data.substr(0, 500);
  },
  {
    retries: 5,
  }
);

API

retry(retrier : Function, opts : Object) => Promise
  • The supplied function can be async or not. In other words, it can be a function that returns a Promise or a value.
  • The supplied function receives two parameters
    1. A Function you can invoke to abort the retrying (bail)
    2. A Number identifying the attempt. The absolute first attempt (before any retries) is 1.
  • The opts are passed to node-retry. Read its docs
    • retries: The maximum amount of times to retry the operation. Default is 10.
    • factor: The exponential factor to use. Default is 2.
    • minTimeout: The number of milliseconds before starting the first retry. Default is 1000.
    • maxTimeout: The maximum number of milliseconds between two retries. Default is Infinity.
    • randomize: Randomizes the timeouts by multiplying with a factor between 1 to 2. Default is true.
    • onRetry: an optional Function that is invoked after a new retry is performed. It's passed the Error that triggered it as a parameter.

Authors

npm-compare.com is an independent website designed to help developers choose the most suitable npm packages. We are not affiliated with npm, Inc, the official website for the npm registry. Note that npm is a registered trademark of npm, Inc. Please share your feedback via our GitHub repository. For more details, please refer to our Terms & Privacy.