sindresorhus

p-locate

module.exports = (iterable, tester, opts) =>

			.then(val => val === true && Promise.reject(new EndError(el)))

// the input can also be a promise, so we `Promise.all()` them both

const finder = el => Promise.all(el).then(val => val[1] === true && Promise.reject(new EndError(val[0])));

module.exports = (iterable, tester, opts) => {

	// start all the promises concurrently with optional limit

	const items = Array.from(iterable).map(el => [el, limit(() => Promise.resolve(el).then(tester))]);

	// check the promises either serially or concurrently

	const checkLimit = pLimit(opts.preserveOrder ? 1 : Infinity);

	return Promise.all(items.map(el => checkLimit(() => finder(el))))

		.catch(err => err instanceof EndError ? err.value : Promise.reject(err));

  "description": "Get the first fulfilled promise that satisfies the provided testing function",

# p-locate [![Build Status](https://travis-ci.org/sindresorhus/p-locate.svg?branch=master)](https://travis-ci.org/sindresorhus/p-locate)

> Get the first fulfilled promise that satisfies the provided testing function

Think of it like an async version of [`Array#find`](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/find).

Here we find the first file that exists on disk, in array order.

const pathExists = require('path-exists');

	'rainbow.png', // only this one actually exists on disk

pLocate(files, file => pathExists(file), {concurrency: 1});

pLocate(files, file => pathExists(file)).then(foundPath => {

*The above is just an example. Use [`locate-path`](https://github.com/sindresorhus/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`.

Set `{concurrency: 1}` to preserve the search order.

Expected to return a `Promise<boolean>` or boolean.

Number of concurrently pending promises returned by `tester`.

Disable this to improve performance if you don't care about the order.

- [p-map](https://github.com/sindresorhus/p-map) - Map over promises concurrently

- [p-filter](https://github.com/sindresorhus/p-filter) - Filter promises concurrently

- [p-any](https://github.com/sindresorhus/p-any) - Wait for any promise to be fulfilled

- [More…](https://github.com/sindresorhus/promise-fun)

		'use strict';
		const pMap = require('p-map');
		const pLimit = require('p-limit');

		@@ -11,9 +11,22 @@ class EndError extends Error {

		module.exports = (iterable, tester, opts) =>
		pMap(iterable, el => (
		Promise.resolve()
		.then(() => tester(el))
		.then(val => val === true && Promise.reject(new EndError(el)))
		), opts)
		// the input can also be a promise, so we `Promise.all()` them both
		const finder = el => Promise.all(el).then(val => val[1] === true && Promise.reject(new EndError(val[0])));

		module.exports = (iterable, tester, opts) => {
		opts = Object.assign({
		concurrency: Infinity,
		preserveOrder: true
		}, opts);

		const limit = pLimit(opts.concurrency);

		// start all the promises concurrently with optional limit
		const items = Array.from(iterable).map(el => [el, limit(() => Promise.resolve(el).then(tester))]);

		// check the promises either serially or concurrently
		const checkLimit = pLimit(opts.preserveOrder ? 1 : Infinity);

		return Promise.all(items.map(el => checkLimit(() => finder(el))))
		.then(() => {})
		.catch(err => err instanceof EndError ? err.value : Promise.reject(err));
		};

		{
		"name": "p-locate",
		"version": "1.0.0",
		"version": "2.0.0",
		"description": "Get the first fulfilled promise that satisfies the provided testing function",
		@@ -42,3 +42,3 @@ "license": "MIT",
		"dependencies": {
		"p-map": "^1.1.0"
		"p-limit": "^1.1.0"
		},
		@@ -45,0 +45,0 @@ "devDependencies": {

		@@ -25,7 +25,10 @@ # p-locate [![Build Status](https://travis-ci.org/sindresorhus/p-locate.svg?branch=master)](https://travis-ci.org/sindresorhus/p-locate)
		'unicorn.png',
		'rainbow.png',
		getUserSpecifiedPath() //=> Promise
		'rainbow.png', // only this one actually exists on disk
		'pony.png'
		];

		pLocate(files, file => pathExists(file), {concurrency: 1});
		pLocate(files, file => pathExists(file)).then(foundPath => {
		console.log(foundPath);
		//=> 'rainbow'
		});
		```
		@@ -46,4 +49,2 @@

		Set `{concurrency: 1}` to preserve the search order.

		#### tester(element)
		@@ -67,3 +68,12 @@

		##### preserveOrder

		Type: `boolean`<br>
		Default: `true`

		Preserve `input` order when searching.

		Disable this to improve performance if you don't care about the order.


		## Related
		@@ -70,0 +80,0 @@

Improved metrics

Dependency changes