node/deps/npm/node_modules/which
Myles Borins ace4fe566f
deps: update npm to 5.5.1
Closes: https://github.com/nodejs/node/pull/16280

PR-URL: https://github.com/nodejs/node/pull/16509
Fixes: https://github.com/nodejs/node/issues/14161
Reviewed-By: Daijiro Wachi <daijiro.wachi@gmail.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Michaël Zasso <targos@protonmail.com>
2017-10-29 21:32:15 -04:00
..
bin deps: upgrade npm to 3.3.10 2015-11-02 14:25:04 -05:00
node_modules/isexe deps: upgrade npm beta to 5.0.0-beta.56 2017-05-23 19:39:43 +02:00
CHANGELOG.md deps: update npm to 5.5.1 2017-10-29 21:32:15 -04:00
LICENSE npm: upgrade to v2.1.18 2015-01-08 23:49:03 +01:00
package.json deps: update npm to 5.5.1 2017-10-29 21:32:15 -04:00
README.md deps: update npm to 5.5.1 2017-10-29 21:32:15 -04:00
which.js deps: update npm to 5.5.1 2017-10-29 21:32:15 -04: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

var which = require('which')

// async usage
which('node', function (er, resolvedPath) {
  // er is returned if no "node" is found on the PATH
  // if it is found, then the absolute path to the exec is returned
})

// sync usage
// throws if not found
var resolved = which.sync('node')

// if nothrow option is used, returns null if not found
resolved = which.sync('node', {nothrow: true})

// Pass options to override the PATH and PATHEXT environment vars.
which('node', { path: someOtherPath }, function (er, resolved) {
  if (er)
    throw er
  console.log('found at %j', resolved)
})

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.