p-locate

2018-10-13 admin

p-locate是什么

什么是p-locate,Get the first fulfilled promise that satisfies the provided testing function

p-locate使用教程帮助文档

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.

Install

$ npm install p-locate

Usage

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'
];

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

	console.log(foundPath);
	//=> 'rainbow'
})();

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

API

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.

input

Type: Iterable<Promise|any>

tester(element)

Type: Function

Expected to return a Promise<boolean> or boolean.

options

Type: Object

concurrency

Type: number Default: Infinity Minimum: 1

Number of concurrently pending promises returned by tester.

preserveOrder

Type: boolean Default: true

Preserve input order when searching.

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

Related

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

License

MIT © Sindre Sorhus

本站文章除注明转载外,均为本站原创或编译。欢迎任何形式的转载,但请务必注明出处。

转载请注明:文章转载自 JavaScript中文网 [https://www.javascriptcn.com]

本文地址:https://www.javascriptcn.com/read-42567.html

文章标题:p-locate

回到顶部