forked from daren.hsu/line_push
88 lines
2.9 KiB
Markdown
88 lines
2.9 KiB
Markdown
# axios-retry
|
|
|
|
[](https://travis-ci.org/softonic/axios-retry)
|
|
|
|
Axios plugin that intercepts failed requests and retries them whenever possible.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
npm install axios-retry
|
|
```
|
|
|
|
### Note
|
|
Not working with `axios 0.19.0`. For details see the [bug](https://github.com/axios/axios/issues/2203). [`axios 0.19.1`](https://github.com/axios/axios/releases/tag/0.19.1) has fixed this bug.
|
|
|
|
## Usage
|
|
|
|
```js
|
|
// 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'
|
|
});
|
|
|
|
// Exponential back-off retry delay between requests
|
|
axiosRetry(axios, { retryDelay: axiosRetry.exponentialDelay});
|
|
|
|
// Custom retry delay
|
|
axiosRetry(axios, { retryDelay: (retryCount) => {
|
|
return retryCount * 1000;
|
|
}});
|
|
|
|
// 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:** Unless `shouldResetTimeout` is set, 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` | `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 between retried requests. By default there is no delay between retries. Another option is exponentialDelay ([Exponential Backoff](https://developers.google.com/analytics/devguides/reporting/core/v3/errors#backoff)). The function is passed `retryCount` and `error`. |
|
|
|
|
## Testing
|
|
|
|
Clone the repository and execute:
|
|
|
|
```bash
|
|
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`
|
|
4. Push to the branch: `git push origin my-new-feature`
|
|
5. Submit a pull request :D
|