mirror of
https://github.com/deployphp/action.git
synced 2024-11-27 06:09:01 +00:00
49 lines
1.2 KiB
Markdown
49 lines
1.2 KiB
Markdown
# which
|
|
|
|
Like the unix `which` utility.
|
|
|
|
Finds the first instance of a specified executable in the PATH
|
|
environment variable. Does not cache the results, so `hash -r` is not
|
|
needed when the PATH changes.
|
|
|
|
## USAGE
|
|
|
|
```javascript
|
|
const which = require('which')
|
|
|
|
// async usage
|
|
// rejects if not found
|
|
const resolved = await which('node')
|
|
|
|
// if nothrow option is used, returns null if not found
|
|
const resolvedOrNull = await which('node', { nothrow: true })
|
|
|
|
// sync usage
|
|
// throws if not found
|
|
const resolved = which.sync('node')
|
|
|
|
// if nothrow option is used, returns null if not found
|
|
const resolvedOrNull = which.sync('node', { nothrow: true })
|
|
|
|
// Pass options to override the PATH and PATHEXT environment vars.
|
|
await which('node', { path: someOtherPath, pathExt: somePathExt })
|
|
```
|
|
|
|
## CLI USAGE
|
|
|
|
Same as the BSD `which(1)` binary.
|
|
|
|
```
|
|
usage: which [-as] program ...
|
|
```
|
|
|
|
## OPTIONS
|
|
|
|
You may pass an options object as the second argument.
|
|
|
|
- `path`: Use instead of the `PATH` environment variable.
|
|
- `pathExt`: Use instead of the `PATHEXT` environment variable.
|
|
- `all`: Return all matches, instead of just the first one. Note that
|
|
this means the function returns an array of strings instead of a
|
|
single string.
|