@esm2cjs/p-any

This is a fork of https://github.com/sindresorhus/p-any, but automatically patched to support ESM and CommonJS, unlike the original repository.

Install

You can use an npm alias to install this package under the original name:

npm i p-any@npm:@esm2cjs/p-any

1// package.json
2"dependencies": {
3    "p-any": "npm:@esm2cjs/p-any"
4}

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

1// package.json
2"dependencies": {
3    "@esm2cjs/p-any": "^ver.si.on"
4}

Usage

1// Using ESM import syntax
2import MOD from "@esm2cjs/p-any";
3
4// Using CommonJS require()
5const MOD = require("@esm2cjs/p-any").default;

Note: Because the original module uses export default, you need to append .default to the require() call.

For more details, please see the original repository.

Sponsoring

To support my efforts in maintaining the ESM/CommonJS hybrid, please sponsor here.

To support the original author of the module, please sponsor here.

p-any

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.

Install

$ npm install p-any

Usage

Checks 3 websites and logs the fastest.

1import pAny from 'p-any';
2import got from 'got';
3
4const first = await pAny([
5	got.head('https://github.com').then(() => 'github'),
6	got.head('https://google.com').then(() => 'google'),
7	got.head('https://twitter.com').then(() => 'twitter'),
8]);
9
10console.log(first);
11//=> 'google'

API

pAny(input, options?)

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.

input

Type: Iterable<Promise | unknown>

options

Type: object

filter

Type: Function

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

AggregateError

Exposed for instance checking.

Related

• 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…