Wait for any promise to be fulfilled

Useful when you need the fastest promise.

You probably want this instead of Promise.race(). Reason.

With Node.js 15, there's now a built-in Promise#any method. The benefit of this package is that it has cancellation functionality.

$ npm install p-any

Checks 3 websites and logs the fastest.

const got = require('got');
const pAny = require('p-any');

(async () => {
	const first = await pAny([
		got.head('https://github.com').then(() => 'github'),
		got.head('https://google.com').then(() => 'google'),
		got.head('https://twitter.com').then(() => 'twitter'),
	]);

	console.log(first);
	//=> 'google'
})();

Returns a cancelable Promise that is fulfilled when any promise from input is fulfilled. If all the input promises reject, it will reject with an AggregateError error.

Type: Iterable<Promise|any>

Type: object

Type: Function

Receives the value resolved by the promise. Used to filter out values that doesn't satisfy a condition.

Exposed for instance checking.

• p-some - Wait for a specified number of promises to be fulfilled
• p-locate - Get the first fulfilled promise that satisfies the provided testing function
• More…