This is a fork of https://github.com/sindresorhus/p-any, but automatically patched to support ESM and CommonJS, unlike the original repository.
You can use an npm alias to install this package under the original name:
npm i p-any@npm:@esm2cjs/p-any
// package.json
"dependencies": {
"p-any": "npm:@esm2cjs/p-any"
}
but npm
might dedupe this incorrectly when other packages depend on the replaced package. If you can, prefer using the scoped package directly:
npm i @esm2cjs/p-any
// package.json
"dependencies": {
"@esm2cjs/p-any": "^ver.si.on"
}
// Using ESM import syntax
import MOD from "@esm2cjs/p-any";
// Using CommonJS require()
const MOD = require("@esm2cjs/p-any").default;
Note: Because the original module uses
export default
, you need to append.default
to therequire()
call.
For more details, please see the original repository.
To support my efforts in maintaining the ESM/CommonJS hybrid, please sponsor here.
To support the original author of the module, please sponsor here.
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.
import pAny from 'p-any';
import got from 'got';
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 | unknown>
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.