?HAMA

Edit File Size: 3.19 KB

//usr/lib/node_modules/npm/node_modules/promise-retry/README.md

Text Base64

# node-promise-retry

[![NPM version][npm-image]][npm-url] [![Downloads][downloads-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Dependency status][david-dm-image]][david-dm-url] [![Dev Dependency status][david-dm-dev-image]][david-dm-dev-url]

[npm-url]:https://npmjs.org/package/promise-retry
[downloads-image]:http://img.shields.io/npm/dm/promise-retry.svg
[npm-image]:http://img.shields.io/npm/v/promise-retry.svg
[travis-url]:https://travis-ci.org/IndigoUnited/node-promise-retry
[travis-image]:http://img.shields.io/travis/IndigoUnited/node-promise-retry/master.svg
[david-dm-url]:https://david-dm.org/IndigoUnited/node-promise-retry
[david-dm-image]:https://img.shields.io/david/IndigoUnited/node-promise-retry.svg
[david-dm-dev-url]:https://david-dm.org/IndigoUnited/node-promise-retry#info=devDependencies
[david-dm-dev-image]:https://img.shields.io/david/dev/IndigoUnited/node-promise-retry.svg

Retries a function that returns a promise, leveraging the power of the [retry](https://github.com/tim-kos/node-retry) module to the promises world.

There's already some modules that are able to retry functions that return promises but
they were rather difficult to use or do not offer an easy way to do conditional retries.

## Installation

`$ npm install promise-retry`

## Usage

### promiseRetry(fn, [options])

Calls `fn` until the returned promise ends up fulfilled or rejected with an error different than
a `retry` error.   
The `options` argument is an object which maps to the [retry](https://github.com/tim-kos/node-retry) module options:

- `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 `false`.

The `fn` function will receive a `retry` function as its first argument that should be called with an error whenever you want to retry `fn`. The `retry` function will always throw an error.   
If there's retries left, it will throw a special `retry` error that will be handled internally to call `fn` again.
If there's no retries left, it will throw the actual error passed to it.

If you prefer, you can pass the options first using the alternative function signature `promiseRetry([options], fn)`.

## Example
```js
var promiseRetry = require('promise-retry');

// Simple example
promiseRetry(function (retry, number) {
    console.log('attempt number', number);

return doSomething()
    .catch(retry);
})
.then(function (value) {
    // ..
}, function (err) {
    // ..
});

// Conditional example
promiseRetry(function (retry, number) {
    console.log('attempt number', number);

return doSomething()
    .catch(function (err) {
        if (err.code === 'ETIMEDOUT') {
            retry(err);
        }

throw err;
    });
})
.then(function (value) {
    // ..
}, function (err) {
    // ..
});
```

## Tests

`$ npm test`

## License

Released under the [MIT License](http://www.opensource.org/licenses/mit-license.php).

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
node_modules DIR	-	drwxr-xr-x	2024-03-03 22:36:29	Edit Download recursive recursive
.editorconfig	220 B	lrw-r--r--	2021-03-10 14:36:38	Edit Download recursive recursive
.npmignore	25 B	lrw-r--r--	2021-03-10 14:36:38	Edit Download recursive recursive
.travis.yml	54 B	lrw-r--r--	2021-03-10 14:36:38	Edit Download recursive recursive
index.js	1.33 KB	lrw-r--r--	2021-03-10 14:36:38	Edit Download recursive recursive
LICENSE	1.03 KB	lrw-r--r--	2021-03-10 14:36:38	Edit Download recursive recursive
package.json	1.80 KB	lrw-r--r--	2021-03-10 14:36:38	Edit Download recursive recursive
README.md	3.19 KB	lrw-r--r--	2021-03-10 14:36:38	Edit Download recursive recursive

Directory Contents