axios-retry

What is axios-retry?

The axios-retry npm package is a utility that allows you to automatically retry failed HTTP requests made using the Axios library. It is particularly useful for dealing with transient errors or unstable network conditions. It provides several options to customize the retry behavior, such as the number of retries, retry delay, and the conditions for which requests should be retried.

What are axios-retry's main functionalities?

Automatic Retries

Automatically retries a failed HTTP request up to a specified number of times.

const axios = require('axios');
const axiosRetry = require('axios-retry');

axiosRetry(axios, { retries: 3 });

axios.get('https://example.com').catch(error => {
  console.error('Request failed:', error);
});

Custom Retry Conditions

Allows you to specify custom conditions for when a request should be retried, such as on certain HTTP status codes or network errors.

const axios = require('axios');
const axiosRetry = require('axios-retry');

axiosRetry(axios, {
  retryCondition: (error) => {
    // Retry on any network error, or 5xx status codes
    return axiosRetry.isNetworkOrIdempotentRequestError(error) || error.response.status === 503;
  }
});

Exponential Backoff

Implements an exponential backoff strategy for the delay between retries, which can help to avoid overwhelming the server.

const axios = require('axios');
const axiosRetry = require('axios-retry');

axiosRetry(axios, {
  retries: 5,
  retryDelay: (retryCount) => {
    return axiosRetry.exponentialDelay(retryCount);
  }
});

Retry on Idempotent Requests Only

Configures the retry mechanism to only retry idempotent requests, which are requests that can be repeated without causing additional side effects.

const axios = require('axios');
const axiosRetry = require('axios-retry');

axiosRetry(axios, {
  retries: 3,
  shouldResetTimeout: true,
  retryCondition: axiosRetry.isIdempotentRequestError
});

Other packages similar to axios-retry

retry-axios

retry-axios is an npm package that provides similar functionality to axios-retry. It allows you to attach retry functionality to Axios requests and configure the number of retries, backoff strategy, and more. It differs in its API and configuration options, offering a different approach to attaching retry behavior to Axios instances or requests.

superagent-retry-delay

superagent-retry-delay is an npm package that extends the Superagent HTTP request library with retry functionality. While it serves a similar purpose to axios-retry, it is specific to Superagent rather than Axios. It allows for configuring retries and delays but is not directly compatible with Axios.

README

axios-retry

Axios plugin that intercepts failed requests and retries them whenever posible.

Installation

npm install axios-retry

Usage

// CommonJS
// const axiosRetry = require('axios-retry');

// ES6
import axiosRetry from 'axios-retry';

axiosRetry(axios, { retries: 3 });

axios.get('http://example.com/test') // The first request fails and the second returns 'ok'
  .then(result => {
    result.data; // 'ok'
  });

// Works with custom axios instances
const client = axios.create({ baseURL: 'http://example.com' });
axiosRetry(client, { retries: 3 });

client.get('/test') // The first request fails and the second returns 'ok'
  .then(result => {
    result.data; // 'ok'
  });

// Allows request-specific configuration
client
  .get('/test', {
    'axios-retry': {
      retries: 0
    }
  })
  .catch(error => { // The first request fails
    error !== undefined
  });

Note: the plugin interprets the request timeout as a global value, so it is not used for each retry but for the whole request lifecycle.

Options

Name	Type	Default	Description
retries	Number	3	The number of times to retry before failing
retryCondition	Function	error => !error.response	A callback to further control if a request should be retried. By default, it retries if the result did not have a response.

Testing

Clone the repository and execute:

npm test

Contribute

1. Fork it: git clone https://github.com/softonic/axios-retry.git
2. Create your feature branch: git checkout -b feature/my-new-feature
3. Commit your changes: git commit -am 'Added some feature'
4. Check the build: npm run build
5. Push to the branch: git push origin my-new-feature
6. Submit a pull request :D

Changelog

[2.0.1] - 2017-06-19

Fixed

• Removed dependency from the package.json file.