await-spawn

> `child_process.spawn()` wrapped in a `Promise` for doing async/await.

Stats

StarsIssuesVersionUpdatedCreatedSize
await-spawn
3124.0.29 months ago4 years agoMinified + gzip package size for await-spawn in KB

Readme

await-spawn

child_process.spawn() wrapped in a Promise for doing async/await.

npm Node version Build Status JavaScript Style Guide

Install

$ npm i await-spawn -S

Usage

const spawn = require('await-spawn')

const main = async () => {
  try {
    const bl = await spawn('ls', ['-al'])
    console.log(bl.toString())
  } catch (e) {
    console.log(e.stderr.toString())
  }
}

main()

Api

Exposes a single function, which has the same api as child_process.spawn().

Returns a Promise with .child set to the spawned child process. The Promise resolves to the buffered output of child.stdout in the form of a BufferList object.

If there was an error, the Promise rejects with an Error object, which has the following extra properties:

  • code the error code
  • stdout the buffered output of stdout in the form of a BufferList object
  • stderr the buffered output of stderr in the form of a BufferList object

Note that child.stdout doesn't exist if options.stdio === 'inherit', so the Promise resolves to ''.

License

MIT

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.