Releases · sindresorhus/execa

11 Mar 23:57

ehmicky

v7.1.0

950d1e6

v7.1.0

Features

Add $ method to write Node.js scripts like zx. For more information, please see this blog post, this section and this page. Thanks @aaronccasanova for this great feature!

import {$} from 'execa';

const branch = await $`git branch --show-current`;
await $`dep deploy --branch=${branch}`;

Add .pipeStdout(), .pipeStderr() and .pipeAll() methods to redirect stdout/stderr to a file, a stream or another process.

// Similar to `echo unicorns > stdout.txt` in Bash
await execa('echo', ['unicorns']).pipeStdout('stdout.txt');

// Similar to `echo unicorns 2> stdout.txt` in Bash
await execa('echo', ['unicorns']).pipeStderr('stderr.txt');

// Similar to `echo unicorns &> stdout.txt` in Bash
await execa('echo', ['unicorns'], {all: true}).pipeAll('all.txt');

Add inputFile option to use a file as stdin.

// Similar to `cat < stdin.txt` in Bash
const {stdout} = await execa('cat', {inputFile: 'stdin.txt'});
console.log(stdout);
//=> 'unicorns'

Add verbose option to print each command on stderr before executing it. This can also be enabled by setting the NODE_DEBUG=execa environment variable in the current process.

> node file.js
unicorns
rainbows

> NODE_DEBUG=execa node file.js
[16:50:03.305] echo unicorns
unicorns
[16:50:03.308] echo rainbows
rainbows

Contributors

aaronccasanova

Assets 2

11 Feb 17:18

sindresorhus

v7.0.0

6bb4a6d

v7.0.0

Breaking

Require Node.js 14 and later (#497) a09cbc0

Fixes

Emit end event on streams when process fails (#518) 30c7a7a
Fix incorrect execaNode signature in index.d.ts (#506) 1f7677c

v6.1.0...v7.0.0

Assets 2

13 Feb 10:41

sindresorhus

v6.1.0

484f28d

v6.1.0

Support AbortController (#490) c6e791a
Allow cwd and localDir options to be URLs (#492) 93ab929

v6.0.0...v6.1.0

Assets 2

17 Nov 11:10

sindresorhus

v6.0.0

e4b9295

v6.0.0

Breaking

Require Node.js 12.20 (#478) 7707880
This package is now pure ESM. Please read this.
Moved from a default export to named exports.
- require('execa') → import {execa} from 'execa'
- require('execa').sync → import {execaSync} from 'execa'
- require('execa').command → import {execaCommand} from 'execa'
- require('execa').commandSync → import {execaCommandSync} from 'execa'
- require('execa').node → import {execaNode} from 'execa'