93 lines
1.7 KiB
TypeScript
93 lines
1.7 KiB
TypeScript
export interface Options {
|
|
/**
|
|
The current working directory.
|
|
|
|
@default process.cwd()
|
|
*/
|
|
readonly cwd?: URL | string;
|
|
|
|
/**
|
|
The type of path to match.
|
|
|
|
@default 'file'
|
|
*/
|
|
readonly type?: 'file' | 'directory';
|
|
|
|
/**
|
|
Allow symbolic links to match if they point to the requested path type.
|
|
|
|
@default true
|
|
*/
|
|
readonly allowSymlinks?: boolean;
|
|
}
|
|
|
|
export interface AsyncOptions extends Options {
|
|
/**
|
|
The number of concurrently pending promises.
|
|
|
|
Minimum: `1`
|
|
|
|
@default Infinity
|
|
*/
|
|
readonly concurrency?: number;
|
|
|
|
/**
|
|
Preserve `paths` order when searching.
|
|
|
|
Disable this to improve performance if you don't care about the order.
|
|
|
|
@default true
|
|
*/
|
|
readonly preserveOrder?: boolean;
|
|
}
|
|
|
|
/**
|
|
Get the first path that exists on disk of multiple paths.
|
|
|
|
@param paths - The paths to check.
|
|
@returns The first path that exists or `undefined` if none exists.
|
|
|
|
@example
|
|
```
|
|
import {locatePath} from 'locate-path';
|
|
|
|
const files = [
|
|
'unicorn.png',
|
|
'rainbow.png', // Only this one actually exists on disk
|
|
'pony.png'
|
|
];
|
|
|
|
console(await locatePath(files));
|
|
//=> 'rainbow'
|
|
```
|
|
*/
|
|
export function locatePath(
|
|
paths: Iterable<string>,
|
|
options?: AsyncOptions
|
|
): Promise<string | undefined>;
|
|
|
|
/**
|
|
Synchronously get the first path that exists on disk of multiple paths.
|
|
|
|
@param paths - The paths to check.
|
|
@returns The first path that exists or `undefined` if none exists.
|
|
|
|
@example
|
|
```
|
|
import {locatePathSync} from 'locate-path';
|
|
|
|
const files = [
|
|
'unicorn.png',
|
|
'rainbow.png', // Only this one actually exists on disk
|
|
'pony.png'
|
|
];
|
|
|
|
console(locatePathSync(files));
|
|
//=> 'rainbow'
|
|
```
|
|
*/
|
|
export function locatePathSync(
|
|
paths: Iterable<string>,
|
|
options?: Options
|
|
): string | undefined;
|