Na}{

File Content: `README.md`

# isexe

Minimal module to check if a file is executable.

Uses `fs.access` if available, and tests against the `PATHEXT`
environment variable on Windows.

## USAGE

```javascript
var isexe = require('isexe')
isexe('some-file-name', function (err, isExe) {
  if (err) {
    console.error('probably file does not exist or something', err)
  } else if (isExe) {
    console.error('this thing can be run')
  } else {
    console.error('cannot be run')
  }
})

// same thing but synchronous, throws errors
var isExe = isexe.sync('some-file-name')

// treat errors as just "not executable"
isexe('maybe-missing-file', { ignoreErrors: true }, callback)
var isExe = isexe.sync('maybe-missing-file', { ignoreErrors: true })
```

## API

### `isexe(path, [options], [callback])`

Check if the path is executable.  If no callback provided, and a
global `Promise` object is available, then a Promise will be returned.

Will raise whatever errors may be raised by `fs.access` or `fs.stat`,
unless `options.ignoreErrors` is set to true.

### `isexe.sync(path, [options])`

Same as `isexe` but returns the value and throws any errors raised.

### Options

* `ignoreErrors` Treat all errors as "no, this is not executable", but
  don't raise them.
* `uid` Number to use as the user id when using the `mode` approach.
* `gid` Number to use as the group id when using the `mode` approach.
* `pathExt` List of path extensions to use instead of `PATHEXT`
  environment variable on Windows.

Name	Size	Permission
.npmignore	23 bytes	0644
LICENSE	765 bytes	0644
README.md	1471 bytes	0644
access.js	237 bytes	0644
index.js	1270 bytes	0644
mode.js	814 bytes	0644
package.json	2103 bytes	0644
windows.js	735 bytes	0644

File Content: README.md

File Content: `README.md`