locate-path
Get the first path that exists on disk of multiple paths
Install
npm install locate-path
Usage
Here we find the first file that exists on disk, in array order.
import {locatePath} from 'locate-path';
const files = [
'unicorn.png',
'rainbow.png', // Only this one actually exists on disk
'pony.png'
];
console.log(await locatePath(files));
//=> 'rainbow.png'
API
locatePath(paths, options?)
Returns a Promise<string> for the first path that exists or undefined if none exists.
paths
Type: Iterable<string>
The paths to check.
options
Type: object
concurrency
Type: number
Default: Infinity
Minimum: 1
The number of concurrently pending promises.
preserveOrder
Type: boolean
Default: true
Preserve paths order when searching.
Disable this to improve performance if you don't care about the order.
cwd
Type: URL | string
Default: process.cwd()
The current working directory.
type
Type: string
Default: 'file'
Values: 'file' | 'directory' | 'both'
The type of path to match.
'file'- Only match files'directory'- Only match directories'both'- Match both files and directories
allowSymlinks
Type: boolean
Default: true
Allow symbolic links to match if they point to the chosen path type.
locatePathSync(paths, options?)
Returns the first path that exists or undefined if none exists.
paths
Type: Iterable<string>
The paths to check.
options
Type: object
cwd
Same as above.
type
Same as above.
allowSymlinks
Same as above.
Related
- path-exists - Check if a path exists