npmpackage.info

Gathering detailed insights and metrics for p-locate

Other packages similar to p-locate

@types/p-locate

2.0.1

Stub TypeScript definitions entry for p-locate, which provides its own types definitions

@cjsa/p-locate

6.0.0-cjsa.0

Get the first fulfilled promise that satisfies the provided testing function

@common.js/p-locate

6.0.0

Get the first fulfilled promise that satisfies the provided testing function

@tocjs/p-locate

6.0.0

Get the first fulfilled promise that satisfies the provided testing function

Gathering detailed insights and metrics for p-locate

p-locate - 6.0.0 | npmpackage.info

p-locate

Get the first fulfilled promise that satisfies the provided testing function

6.0.0

MIT

JavaScript

842.00 B

24,785,539,302 4.2

Installations

npm install p-locate

Developer Guide

BETA

Typescript

No

Module System

ESM

Min. Node Version

^12.20.0 || ^14.13.1 || >=16.0.0

Node Version

16.7.0

NPM Version

7.20.3 Score

99.5

Supply Chain

96.2

Quality

75.5

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

0

Total

8

Closed

1

Merged

7

Issues

Open

1

Total

2

Closed

1

Releases

v6.0.0

Updated on Aug 25, 2021

v5.0.0

Updated on Aug 10, 2020

v4.1.0

Updated on Apr 04, 2019

v4.0.0

Updated on Mar 12, 2019

View All 4 releases

Languages

JavaScript

TypeScript

JavaScript (80.48%)

TypeScript (19.52%)

Developer

sindresorhus

Download Statistics

Total Downloads

24,785,539,302

Last Day

9,069,776

Last Week

152,279,648

Last Month

655,861,389

Last Year

6,625,666,099

GitHub Statistics

MIT License

76 Stars

24 Commits

8 Forks

5 Watchers

1 Branches

6 Contributors

Updated on May 23, 2025

Bundle Size

1.60 kB

Minified

842.00 B

Minified + Gzipped

Bundlephobia

Sponsor this package

https://github.com/sponsors/sindresorhus

Maintainers

View All 6 Contributors

Package Meta Information

Latest Version

6.0.0

Package Id

p-locate@6.0.0

Size

3.00 kB

NPM Version

7.20.3

Node Version

16.7.0

Published on

Aug 25, 2021

Total Downloads

Cumulative downloads

Total Downloads

24,785,539,302

Last Day

-9.4%

9,069,776

Compared to previous day

Last Week

-8%

152,279,648

Compared to previous week

Last Month

3.8%

655,861,389

Compared to previous month

Last Year

15%

6,625,666,099

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

p-limit

Dev Dependencies

ava delay in-range time-span tsd xo

p-locate

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.

1import {pathExists} from 'path-exists';
2import pLocate from 'p-locate';
3
4const files = [
5	'unicorn.png',
6	'rainbow.png', // Only this one actually exists on disk
7	'pony.png'
8];
9
10const foundPath = await pLocate(files, file => pathExists(file));
11
12console.log(foundPath);
13//=> '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 | unknown>

An iterable of promises/values to test.

tester(element)

Type: Function

This function will receive resolved values from input and is expected to return a Promise<boolean> or boolean.

options

Type: object

concurrency

Type: number
Default: Infinity
Minimum: 1

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

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

Get professional support for this package with a Tidelift subscription
_{Tidelift helps make open source sustainable for maintainers while giving companies
assurances about security, maintenance, and licensing for their dependencies.}

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

Score

4.2

/10

Last Scanned on 2025-06-23

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to p-locate

Other packages similar to p-locate

p-locate

Installations

Developer Guide

No

ESM

^12.20.0 || ^14.13.1 || >=16.0.0

16.7.0

7.20.3

Score

Pull Requests

0

8

1

7

Issues

1

2

1

Releases

Languages

Developer

sindresorhus

Download Statistics

GitHub Statistics

Bundle Size

1.60 kB

842.00 B

Sponsor this package

Maintainers

Package Meta Information

Total Downloads

24,785,539,302

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Dev Dependencies

p-locate

Install

Usage

API

pLocate(input, tester, options?)

input

tester(element)

options

concurrency

preserveOrder

Related

10

10

10

10

10

2

0

0

0

0

0

0

0

4.2

/10