https://github.com/busterc/promise-do-until

:loop: Calls a function repeatedly until a condition returns true and then resolves the promise
https://github.com/busterc/promise-do-until

es6-promise flow-control promise promise-library promise-modules promises

Last synced: about 2 months ago
JSON representation

:loop: Calls a function repeatedly until a condition returns true and then resolves the promise

• Host: GitHub
• URL: https://github.com/busterc/promise-do-until
• Owner: busterc
• License: isc
• Created: 2015-11-25T22:11:37.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2018-08-25T21:46:41.000Z (almost 6 years ago)
• Last Synced: 2024-02-02T05:20:39.158Z (5 months ago)
• Topics: es6-promise, flow-control, promise, promise-library, promise-modules, promises
• Language: JavaScript
• Homepage:
• Size: 5.86 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-promises - promise-do-until - Calls a function repeatedly until a condition returns true and then resolves the promise. (Convenience Utilities / Others)

README

        
# promise-do-until [![NPM version][npm-image]][npm-url] [![Build Status][travis-image]][travis-url] [![Dependency Status][daviddm-image]][daviddm-url]

> Calls a function repeatedly until a condition returns true and then resolves the promise

- See Also

  - [promise-until](https://github.com/busterc/promise-until)

  - [promise-whilst](https://github.com/sindresorhus/promise-whilst)

  - [promise-do-whilst](https://github.com/busterc/promise-do-whilst)

## Installation

```sh

$ npm install --save promise-do-until

```

## Usage

```js

import promiseDoUntil from 'promise-do-until';

let count = 0;

promiseDoUntil(() => {

  count++;

}, () => {

  return count === 5;

}).then(() => {

  console.log(count);

  // => 5

});

// ...

let max = 0;

promiseDoUntil(() => {

  max++;

}, () => {

  return max > -1;

}).then(() => {

  console.log(max);

  // => 1

});

```

## API

### promiseDoUntil(action, condition)

Executes `action` repeatedly until `condition` returns `true` and then resolves the promise. Rejects if `action` returns a promise that rejects or if an error is thrown anywhere.

#### action

Type: `function`

Action to run for each iteration.

You can return a promise and it will be handled.

#### condition

Type: `function`

Should return a boolean of whether to continue.

## License

ISC © [Buster Collings]()

[npm-image]: https://badge.fury.io/js/promise-do-until.svg

[npm-url]: https://npmjs.org/package/promise-do-until

[travis-image]: https://travis-ci.org/busterc/promise-do-until.svg?branch=master

[travis-url]: https://travis-ci.org/busterc/promise-do-until

[daviddm-image]: https://david-dm.org/busterc/promise-do-until.svg?theme=shields.io

[daviddm-url]: https://david-dm.org/busterc/promise-do-until