This is a proof-of-concept fork of cross-spawn while I wait for a fix to be merged upstream.
A cross platform solution to node's spawn and spawnSync.
$ npm install @cspotcode/cross-spawn
If you are using
spawnSync on node 0.10 or older, you will also need to install
$ npm install spawn-sync
Node has issues when using spawn on Windows:
- It ignores PATHEXT
- It does not support shebangs
options.shellsupport on node
- It does not allow you to run
All these issues are handled correctly by
There are some known modules, such as win-spawn, that try to solve this but they are either broken or provide faulty escaping of shell arguments.
var spawn = ;// Spawn NPM asynchronouslyvar child = ;// Spawn NPM synchronouslyvar results = spawn;
options.shell as an alternative to
Starting from node
spawn has a
shell option that allows you run commands from within a shell. This new option solves most of the problems that
@cspotcode/cross-spawn attempts to solve, but:
- It's not supported in node
- It has no support for shebangs on Windows
- You must manually escape the command and arguments which is very error prone, specially when passing user input
If you are using the
shell option to spawn a command in a cross platform way, consider using
@cspotcode/cross-spawn instead. You have been warned.
@cspotcode/cross-spawn handles shebangs on Windows, its support is limited: e.g.: it doesn't handle arguments after the path, e.g.:
Remember to always test your code on Windows!
$ npm test
Released under the MIT License.