Eric Foster 35b96bc934 initial commit | 6 年 前 | |
---|---|---|
.. | ||
index.js | 6 年 前 | |
license | 6 年 前 | |
package.json | 6 年 前 | |
readme.md | 6 年 前 |
Get the first fulfilled promise that satisfies the provided testing function
Think of it like an async version of Array#find
.
$ npm install --save p-locate
Here we find the first file that exists on disk, in array order.
const pathExists = require('path-exists');
const pLocate = require('p-locate');
const files = [
'unicorn.png',
'rainbow.png', // only this one actually exists on disk
'pony.png'
];
pLocate(files, file => pathExists(file)).then(foundPath => {
console.log(foundPath);
//=> 'rainbow'
});
The above is just an example. Use locate-path
if you need this.
Returns a Promise
that is fulfilled when tester
resolves to true
or the iterable is done, or rejects if any of the promises reject. The fulfilled value is the current iterable value or undefined
if tester
never resolved to true
.
Type: Iterable<Promise|any>
Type: Function
Expected to return a Promise<boolean>
or boolean.
Type: Object
Type: number
Default: Infinity
Minimum: 1
Number of concurrently pending promises returned by tester
.
Type: boolean
Default: true
Preserve input
order when searching.
Disable this to improve performance if you don't care about the order.
MIT © Sindre Sorhus