Purpose

Minimalist, efficient and performance focused retry system. Basically it helps developer to retry a function with a specific interval, exponential factor etc.

No dependency.

Compatibility

/!\ This module use async/await syntax, this is why you must have node 7.6+.

Supported and tested : >= 7.6

Version	Supported	Tested
20.x	yes	yes
18.x	yes	yes
16.x	yes	yes
14.x	yes	yes
12.x	no	yes
10.x	no	yes
9.x	no	yes
8.x	no	yes
>= 7.6	no	yes

Installation

1$ npm install async-await-retry --save

Usage

Basic usage

1const retry = require('async-await-retry');
2
3const func = async () => {return new Promise((resolve) => resolve('OK'))};
4
5try {
6    const res = await retry(func)
7} catch (err) {
8    console.log('The function execution failed !')
9}

Sync function syntax

1const retry = require('async-await-retry');
2
3const func = () => {...};
4
5try {
6    const res = await retry(func)
7    console.log(res) // output : OK
8} catch (err) {
9    console.log('The function execution failed !')
10}

Anonymous function style

1const retry = require('async-await-retry');
2
3try {
4    const res = await retry(async () => {
5      return new Promise((resolve) => resolve('OK'))
6    })
7    
8    console.log(res) // output : OK
9} catch (err) {
10    console.log('The function execution failed !')
11}

Callback function style

1const retry = require('async-await-retry');
2
3try {
4    const res = await retry((arg1, cb) => {
5        ....
6        cb(err, data); // send err as first argument
7    }, ["arg1"], {isCb: true});
8} catch (err) {
9    console.log('The function execution failed !')
10}

Options

## retry(function, [args], [config])

• function : function to retry in case of error
• args : your function's parameters in case you don't use callback style
• config : an object containing all retry process options

options

Option	description	Default value
retriesMax	Maximum number of retries	3
interval	Delay in ms between two tentatives	0
exponential	Will the interval increase exponentially ?	true
maxBackoff	Maximum delay before to retry (with exponential)	30s
factor	The exponential factor to use	2
jitter	Random jitter in ms to add to the interval	0
isCb	Old callback function style ?	false
onAttemptFail	User's callback to manage retry system	default fallback

An example of custom options :

1const retry = require('async-await-retry');
2
3try {
4    const res = await retry(async () => {
5      return new Promise((resolve) => resolve('OK'))
6    }, null, {retriesMax: 4, interval: 100, exponential: true, factor: 3, jitter: 100})
7    
8    console.log(res) // output : OK
9} catch (err) {
10    console.log('The function execution failed !')
11}

onAttemptFail

This method can be used to manage, by yourself, the retry system. It's called when an error occurred and before to retry. This method can have three behaviors:

• you can throw an error
• if it returns truthy value then normal retry system continues
• if it returns falsy value then the retry system stop

1const retry = require('async-await-retry');
2
3try {
4    const res = await retry(MyfuncToRetry, null, {
5        onAttemptFail: (data) => {
6            // do some stuff here, like logging errors
7        }
8    });
9} catch (err) {
10    console.log('The function execution failed !')
11}

The data argument is an object that can be described like this:

Property	description
error	The current error object
currentRetry	The current retry value
retriesMax	Maximum number of retries
interval	Delay in ms between two tentatives
exponential	Will the interval increase exponentially ?
factor	The exponential factor to use
jitter	Random jitter in ms to add to the interval
maxBackoff	Maximum delay before to retry

Test

1$ npm test

Coverage report can be found in coverage/.