NestJS Axios Retry Module

nestjs-axios-retry is a module for NestJS that adds retry functionality to Axios HTTP requests. It leverages axios-retry to provide configurable options for retrying failed HTTP requests, making your NestJS applications more resilient to transient errors.

Features

• Easy integration with NestJS's HttpModule.
• Configurable retry count, delay, and conditions.
• Support for exponential backoff.
• Custom callbacks for retry events.

Blog Article

For more details on the motivation behind this module, please refer to the following blog article: Adding Retry Functionality to NestJS HTTP Requests

Installation

1npm install nestjs-axios-retry axios-retry

Usage First, import and configure AxiosRetryModule in your NestJS module:

1import { Module } from '@nestjs/common';
2import { AxiosRetryModule } from 'nestjs-axios-retry';
3import axiosRetry from 'axios-retry';
4
5@Module({
6  imports: [
7    AxiosRetryModule.forRoot({
8      axiosRetryConfig: {
9        retries: 5,
10        retryDelay: axiosRetry.exponentialDelay,
11        shouldResetTimeout: true,
12        retryCondition: (error) => error.response.status === 429,
13        onRetry: (retryCount, error, requestConfig) => {
14          console.log(`Retrying request attempt ${retryCount}`);
15        },
16      },
17    }),
18  ],
19  // ... Other configurations
20})
21export class AppModule {}

Then, inject the HttpService provided by NestJS into your service or controller:

Basic Usage

Use the HttpService provided by NestJS to make HTTP requests. The retry functionality is automatically applied based on your module configuration.

1import { Injectable } from '@nestjs/common';
2import { HttpService } from '@nestjs/axios';
3import { firstValueFrom } from 'rxjs';
4
5@Injectable()
6export class AppService {
7  constructor(private httpService: HttpService) {}
8
9  async fetchData() {
10    const response = await firstValueFrom(
11      this.httpService.get('https://example.com/data'),
12    );
13    return response.data;
14  }
15}

Advanced Usage

Custom Retry Configuration You can customize the retry behavior for individual requests:

1async fetchDataWithCustomRetry() {
2  const response = await firstValueFrom(
3    this.httpService.get('https://example.com/data', {
4      'axios-retry': {
5        retries: 5,
6        retryDelay: (retryCount) => retryCount * 1000,
7      },
8    }),
9  );
10  return response.data;
11}

Exponential Backoff Retry For exponential backoff strategy:

1async fetchDataWithExponentialBackoff() {
2  const response = await firstValueFrom(
3    this.httpService.get('https://example.com/data', {
4      'axios-retry': {
5        retries: 3,
6        retryDelay: axiosRetry.exponentialDelay,
7      },
8    }),
9  );
10  return response.data;
11}

Specific Retry Condition Customize the condition under which a

retry should occur:

1async fetchDataWithRetryCondition() {
2  const response = await firstValueFrom(
3    this.httpService.get('https://example.com/data', {
4      'axios-retry': {
5        retries: 3,
6        retryCondition: (error) => error.response.status === 503,
7      },
8    }),
9  );
10  return response.data;
11}

OnRetry Callback Implement custom actions on each retry:

1async fetchDataWithOnRetryCallback() {
2  const response = await firstValueFrom(
3    this.httpService.get('https://example.com/data', {
4      'axios-retry': {
5        retries: 3,
6        onRetry: (retryCount, error, requestConfig) => {
7          console.log(`Retrying request attempt ${retryCount}`);
8        },
9      },
10    }),
11  );
12  return response.data;
13}
14
15// Basic fetch data example
16  async fetchData() {
17    const response = await firstValueFrom(
18      this.httpService.get('https://example.com/data'),
19    );
20    return response.data;
21  }
22
23  // Fetch with custom retry configuration
24  async fetchDataWithCustomRetry() {
25    const response = await firstValueFrom(
26      this.httpService.get('https://example.com/data', {
27        'axios-retry': {
28          retries: 5,
29          retryDelay: (retryCount) => retryCount * 1000,
30        },
31      }),
32    );
33    return response.data;
34  }
35
36  // Fetch with exponential backoff retry
37  async fetchDataWithExponentialBackoff() {
38    const response = await firstValueFrom(
39      this.httpService.get('https://example.com/data', {
40        'axios-retry': {
41          retries: 3,
42          retryDelay: axiosRetry.exponentialDelay,
43        },
44      }),
45    );
46    return response.data;
47  }
48
49  // Fetch with specific retry condition
50  async fetchDataWithRetryCondition() {
51    const response = await firstValueFrom(
52      this.httpService.get('https://example.com/data', {
53        'axios-retry': {
54          retries: 3,
55          retryCondition: (error) => error?.response?.status === 503,
56        },
57      }),
58    );
59    return response.data;
60  }
61
62  // Fetch with onRetry callback
63  async fetchDataWithOnRetryCallback() {
64    const response = await firstValueFrom(
65      this.httpService.get('https://example.com/data', {
66        'axios-retry': {
67          retries: 3,
68          onRetry: (retryCount, error, requestConfig) => {
69            console.log(`Retrying request attempt ${retryCount}`);
70          },
71        },
72      }),
73    );
74    return response.data;
75  }

Name	Type	Default	Description
retries	Number	3	The number of times to retry before failing. 1 = One retry after first failure
retryCondition	Function	isNetworkOrIdempotentRequestError	A callback to further control if a request should be retried. By default, it retries if it is a network error or a 5xx error on an idempotent request (GET, HEAD, OPTIONS, PUT or DELETE).
shouldResetTimeout	Boolean	false	Defines if the timeout should be reset between retries
retryDelay	Function	function noDelay() { return 0; }	A callback to further control the delay in milliseconds between retried requests. By default there is no delay between retries. Another option is exponentialDelay (Exponential Backoff). The function is passed retryCount and error.
onRetry	Function	function onRetry(retryCount, error, requestConfig) { return; }	A callback to notify when a retry is about to occur. Useful for tracing and you can any async process for example refresh a token on 401. By default nothing will occur. The function is passed retryCount, error, and requestConfig.

Credits This module is based on the work of (axios-retry). Please refer to the axios-retry documentation for more details on the retry configuration options.

Contributing Contributions to nestjs-axios-retry are welcome! Please refer to the project's issues and pull request sections for more details.

License This project is licensed under the MIT License - see the LICENSE file for details.