p-one

p-one

Test whether some promise passes a testing function

Like Array.some for promises.

Install

$ npm install --save p-one

Usage

const pOne = require('p-one');
const getContinent = require('get-continent'); // not a real module

const places = [
	getCapital('Norway').then(info => info.name),
	'Bangkok, Thailand',
	'Berlin, Germany',
	'Tokyo, Japan'
];

const testingFunction = x => getContinent(x).then(x => x === 'europe');

pOne(places, testingFunction).then(result => {
	console.log(result);
	//=> true
});

API

pOne(input, testingFunction, [options])

Returns a Promise that is fulfilled when any promise in input and ones returned from testingFunction are fulfilled, or rejects if any of the promises reject. The fulfilled value is a boolean that is true if any promise passed the test and false otherwise.

input

Type: Iterable<Promise|any>

Iterated over concurrently in the testingFunction function.

testingFunction(element, index)

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 testingFunction.

Related

• p-every - Test whether all promises passes a testing function
• p-filter - Filter promises concurrently
• p-locate - Get the first fulfilled promise that satisfies the provided testing function
• p-map - Map over promises concurrently
• More…

License

MIT © Kevin Martensson