Get the first fulfilled promise that satisfies the provided testing function
Last updated a year ago by sindresorhus .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install p-locate 
SYNC missed versions from official npm registry.

p-locate Build Status

Get the first fulfilled promise that satisfies the provided testing function

Think of it like an async version of Array#find.


$ npm install 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 = [
	'rainbow.png', // Only this one actually exists on disk

(async () => {
	const foundPath = await pLocate(files, file => pathExists(file));

	//=> 'rainbow'

The above is just an example. Use locate-path if you need this.


pLocate(input, tester, [options])

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 | unknown>

An iterable of promises/values to test.


Type: Function

This function will receive resolved values from input and is 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.


  • p-map - Map over promises concurrently
  • p-filter - Filter promises concurrently
  • p-any - Wait for any promise to be fulfilled
  • More…


MIT © Sindre Sorhus

Current Tags

  • 4.1.0                                ...           latest (a year ago)

5 Versions

  • 4.1.0                                ...           a year ago
  • 4.0.0                                ...           a year ago
  • 3.0.0                                ...           2 years ago
  • 2.0.0                                ...           3 years ago
  • 1.0.0                                ...           4 years ago

Copyright 2014 - 2016 © taobao.org |