deployphp/node_modules/which
Anton Medvedev 363bb1be96 Update deps
2023-03-28 17:15:22 +02:00
..
bin Update deps 2023-03-28 17:15:22 +02:00
lib Update deps 2023-03-28 17:15:22 +02:00
LICENSE Add n_m 2020-11-10 23:12:02 +01:00
package.json Update deps 2023-03-28 17:15:22 +02:00
README.md Update deps 2023-03-28 17:15:22 +02:00

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

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.