https://github.com/zentrick/cross-spawn-promise
Promisified cross-spawn.
https://github.com/zentrick/cross-spawn-promise
Last synced: 5 months ago
JSON representation
Promisified cross-spawn.
- Host: GitHub
- URL: https://github.com/zentrick/cross-spawn-promise
- Owner: zentrick
- License: mit
- Created: 2016-03-02T15:28:32.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2020-05-25T15:37:24.000Z (almost 5 years ago)
- Last Synced: 2024-11-11T18:12:17.269Z (6 months ago)
- Language: JavaScript
- Homepage:
- Size: 795 KB
- Stars: 25
- Watchers: 2
- Forks: 7
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-nodejs - cross-spawn-promise - Promisified cross-spawn. (Repository / Shell)
README
# cross-spawn-promise
[](https://www.npmjs.com/package/cross-spawn-promise) [](https://david-dm.org/zentrick/cross-spawn-promise) [](https://circleci.com/gh/zentrick/cross-spawn-promise) [](https://ci.appveyor.com/project/zentrick/cross-spawn-promise) [](https://coveralls.io/r/zentrick/cross-spawn-promise) [](http://standardjs.com/)
Promisified [cross-spawn](https://www.npmjs.com/package/cross-spawn).
## Usage
```js
import spawn from 'cross-spawn-promise'const command = 'ls'
const args = ['-al', '/etc']
const options = {}
spawn(command, args, options)
.then((stdout) => {
console.info('Success!')
console.info('stdout:', stdout.toString())
})
.catch((error) => {
console.error('Failed!')
console.error('exit status:', error.exitStatus)
console.error('stderr:', error.stderr.toString())
})
```## API
```js
async spawn(command[, args][, options])
```The returned `Promise` will resolve to the process's standard output. Depending
on the value of the `encoding` option (see below), it will either be a
[`Buffer`](https://nodejs.org/api/buffer.html) or a string.The promise also exposes the created child process via its `childProcess`
property.Upon rejection, the following properties provide additional information on the
`Error` object:- `exitSignal`
- `exitStatus`
- `stdout`
- `stderr`## Options
All options are passed on to
[cross-spawn](https://www.npmjs.com/package/cross-spawn), with the exception of
the additional `encoding` option. If you pass a string (e.g., `'utf8'`), it will
be used as the
[default character encoding](https://nodejs.org/api/stream.html#stream_readable_setencoding_encoding).## Maintainer
[Tim De Pauw](https://github.com/timdp)
## License
MIT