sindresorhus

locate-path

	Allow symbolic links to match if they point to the requested path type.

export interface AsyncOptions extends Options {

	The number of concurrently pending promises.

	Disable this to improve performance if you don't care about the order.

Get the first path that exists on disk of multiple paths.

@returns The first path that exists or `undefined` if none exists.

	'rainbow.png', // Only this one actually exists on disk

Synchronously get the first path that exists on disk of multiple paths.

import {locatePathSync} from 'locate-path';

import fs, {promises as fsPromises} from 'node:fs';

	throw new Error(`Invalid type specified: ${type}`);

const matchType = (type, stat) => type === undefined || stat[typeMappings[type]]();

const toPath = urlOrPath => urlOrPath instanceof URL ? fileURLToPath(urlOrPath) : urlOrPath;

	const statFunction = allowSymlinks ? fsPromises.stat : fsPromises.lstat;

			const stat = await statFunction(path.resolve(cwd, path_));

	const statFunction = allowSymlinks ? fs.statSync : fs.lstatSync;

			const stat = statFunction(path.resolve(cwd, path_));

	"description": "Get the first path that exists on disk of multiple paths",

	"repository": "sindresorhus/locate-path",

	"funding": "https://github.com/sponsors/sindresorhus",

		"node": "^12.20.0 || ^14.13.1 || >=16.0.0"

> Get the first path that exists on disk of multiple paths

Here we find the first file that exists on disk, in array order.

Returns a `Promise<string>` for the first path that exists or `undefined` if none exists.

The number of concurrently pending promises.

Disable this to improve performance if you don't care about the order.

Allow symbolic links to match if they point to the chosen path type.

Returns the first path that exists or `undefined` if none exists.

- [path-exists](https://github.com/sindresorhus/path-exists) - Check if a path exists

		<a href="https://tidelift.com/subscription/pkg/npm-locate-path?utm_source=npm-locate-path&utm_medium=referral&utm_campaign=readme">Get professional support for this package with a Tidelift subscription</a>

		Tidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.

		@@ -7,3 +7,3 @@ export interface Options {
		*/
		readonly cwd?: string;
		readonly cwd?: URL \| string;

		@@ -10,0 +10,0 @@ /**

		import process from 'node:process';
		import path from 'node:path';
		import fs, {promises as fsPromises} from 'node:fs';
		import {fileURLToPath} from 'node:url';
		import pLocate from 'p-locate';
		@@ -21,2 +22,4 @@

		const toPath = urlOrPath => urlOrPath instanceof URL ? fileURLToPath(urlOrPath) : urlOrPath;

		export async function locatePath(
		@@ -33,2 +36,3 @@ paths,
		checkType(type);
		cwd = toPath(cwd);

		@@ -56,2 +60,3 @@ const statFunction = allowSymlinks ? fsPromises.stat : fsPromises.lstat;
		checkType(type);
		cwd = toPath(cwd);

		@@ -58,0 +63,0 @@ const statFunction = allowSymlinks ? fs.statSync : fs.lstatSync;

		{
		"name": "locate-path",
		"version": "7.0.0",
		"version": "7.1.0",
		"description": "Get the first path that exists on disk of multiple paths",
		@@ -5,0 +5,0 @@ "license": "MIT",

		@@ -63,3 +63,3 @@ # locate-path

		Type: `string`\
		Type: `URL \| string`\
		Default: `process.cwd()`
		@@ -84,3 +84,3 @@

		### locatePath.sync(paths, options?)
		### locatePathSync(paths, options?)

		@@ -87,0 +87,0 @@ Returns the first path that exists or `undefined` if none exists.

Improved metrics