https://github.com/cachecontrol/promise-every-series
Execute promises in series, testing that each result satisfies a condition.
https://github.com/cachecontrol/promise-every-series
Last synced: 5 months ago
JSON representation
Execute promises in series, testing that each result satisfies a condition.
- Host: GitHub
- URL: https://github.com/cachecontrol/promise-every-series
- Owner: CacheControl
- License: mit
- Created: 2015-03-28T16:18:04.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2015-10-26T00:24:02.000Z (over 10 years ago)
- Last Synced: 2024-10-12T14:51:07.997Z (over 1 year ago)
- Language: JavaScript
- Homepage:
- Size: 150 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Promise Every Series
[](http://standardjs.com/)
Given an array of methods that return promises, execute in series and return true if all satisfy a test.
This library is useful when having a set of prioritized promises to check, and you'd like to test the fast(cheap) calls first, short circuiting if they fail the test.
For example, if you needed to check several conditions, involving synchronous code(fast), local database calls(less fast), and third party services(slow), you'd want to execute the fast one first, followed by the slower ones, and so forth, stopping immediately if any fail the test.
## Installation
```$ npm install promise-every-series```
## Basic Usage
```javascript
var everySeries = require('promise-every-series');
var superFast = function() {
return new Promise(function(resolve, reject) {
console.log('superFast ran!');
resolve(true);
});
};
var sortaSlow = function() {
return new Promise(function(resolve, reject) {
console.log('sortaSlow ran!');
resolve(false);
});
};
var superDuperSlow = function() {
return new Promise(function(resolve, reject) {
console.log('superDuperSlow ran!');
resolve(true);
});
};
everySeries([superFast, sortaSlow, superDuperSlow], function(res) {
return res === true; //only promises that resolve(true) pass the test
}).then( (result) => {
console.log(result);
});
```
This will print:
```javascript
superFast ran!
sortaSlow ran!
false //note that superDuperSlow did not run
```
## Inputs
Empty arrays or failing to provide a valid callback immediately resolve as false.
```javascript
everySeries([]).then( (data) => {
console.log(results); //false
});
```
This will print:
```javascript
false
```