1. module cross-spawn-async
   1. function cross-spawn-async (command, args, options)
   2. function cross-spawn-async._parse (command, args, options)
   3. function cross-spawn-async.spawn (command, args, options)
   4. object cross-spawn-async._enoent
2. module cross-spawn-async._enoent
   1. function cross-spawn-async._enoent.hookChildProcess (cp, parsed)
   2. function cross-spawn-async._enoent.notFoundError (command, syscall)
   3. function cross-spawn-async._enoent.verifyENOENT (status, parsed, syscall)
3. module cross-spawn-async.spawn
   1. function cross-spawn-async.spawn (command, args, options)
   2. function cross-spawn-async.spawn._parse (command, args, options)
   3. object cross-spawn-async.spawn._enoent

module cross-spawn-async

function cross-spawn-async (command, args, options)

• description and source-code

  function spawn(command, args, options) {
      var parsed;
      var spawned;
  
      // Parse the arguments
      parsed = parse(command, args, options);
  
      // Spawn the child process
      spawned = cp.spawn(parsed.command, parsed.args, parsed.options);
  
      // Hook into child process "exit" event to emit an error if the command
      // does not exists, see: https://github.com/IndigoUnited/node-cross-spawn/issues/16
      enoent.hookChildProcess(spawned, parsed);
  
      return spawned;
  }

• example usage

  n/a

function cross-spawn-async._parse (command, args, options)

• description and source-code

  function parse(command, args, options) {
      var shebang;
      var applyQuotes;
      var file;
      var original;
  
      // Normalize arguments, similar to nodejs
      if (args && !Array.isArray(args)) {
          options = args;
          args = null;
      }
  
      args = args ? args.slice(0) : [];  // Clone array to avoid changing the original
      options = options || {};
      original = command;
  
      if (isWin) {
          // Detect & add support for shebangs
          file = resolveCommand(command);
          file = file || resolveCommand(command, true);
          shebang = file && readShebang(file);
  
          if (shebang) {
              args.unshift(file);
              command = shebang;
          }
  
          // Escape command & arguments
          applyQuotes = command !== 'echo';  // Do not quote arguments for the special "echo" command
          command = escapeCommand(command);
          args = args.map(function (arg) {
              return escapeArg(arg, applyQuotes);
          });
  
          // Use cmd.exe
          args = ['/s', '/c', '"' + command + (args.length ? ' ' + args.join(' ') : '') + '"'];
          command = process.env.comspec || 'cmd.exe';
  
          // Tell node's spawn that the arguments are already escaped
          options.windowsVerbatimArguments = true;
      }
  
      return {
          command: command,
          args: args,
          options: options,
          file: file,
          original: original,
      };
  }

• example usage

  n/a

function cross-spawn-async.spawn (command, args, options)

• description and source-code

  function spawn(command, args, options) {
      var parsed;
      var spawned;
  
      // Parse the arguments
      parsed = parse(command, args, options);
  
      // Spawn the child process
      spawned = cp.spawn(parsed.command, parsed.args, parsed.options);
  
      // Hook into child process "exit" event to emit an error if the command
      // does not exists, see: https://github.com/IndigoUnited/node-cross-spawn/issues/16
      enoent.hookChildProcess(spawned, parsed);
  
      return spawned;
  }

• example usage

  ...
      var parsed;
      var spawned;
  
      // Parse the arguments
      parsed = parse(command, args, options);
  
      // Spawn the child process
      spawned = cp.spawn(parsed.command, parsed.args, parsed.options);
  
      // Hook into child process "exit" event to emit an error if the command
      // does not exists, see: https://github.com/IndigoUnited/node-cross-spawn/issues/16
      enoent.hookChildProcess(spawned, parsed);
  
      return spawned;
  }
  ...

module cross-spawn-async._enoent

function cross-spawn-async._enoent.hookChildProcess (cp, parsed)

• description and source-code

  function hookChildProcess(cp, parsed) {
      var originalEmit;
  
      if (!isWin) {
          return;
      }
  
      originalEmit = cp.emit;
      cp.emit = function (name, arg1) {
          var err;
  
          // If emitting "exit" event and exit code is 1, we need to check if
          // the command exists and emit an "error" instead
          // See: https://github.com/IndigoUnited/node-cross-spawn/issues/16
          if (name === 'exit') {
              err = verifyENOENT(arg1, parsed, 'spawn');
  
              if (err) {
                  return originalEmit.call(cp, 'error', err);
              }
          }
  
          return originalEmit.apply(cp, arguments);
      };
  }

• example usage

  ...
      parsed = parse(command, args, options);
  
      // Spawn the child process
      spawned = cp.spawn(parsed.command, parsed.args, parsed.options);
  
      // Hook into child process "exit" event to emit an error if the command
      // does not exists, see: https://github.com/IndigoUnited/node-cross-spawn/issues/16
      enoent.hookChildProcess(spawned, parsed);
  
      return spawned;
  }
  
  module.exports = spawn;
  module.exports.spawn = spawn;
  module.exports._parse = parse;
  ...

function cross-spawn-async._enoent.notFoundError (command, syscall)

• description and source-code

  function notFoundError(command, syscall) {
      var err;
  
      err = new Error(syscall + ' ' + command + ' ENOENT');
      err.code = err.errno = 'ENOENT';
      err.syscall = syscall + ' ' + command;
  
      return err;
  }

• example usage

  n/a

function cross-spawn-async._enoent.verifyENOENT (status, parsed, syscall)

• description and source-code

  function verifyENOENT(status, parsed, syscall) {
      if (isWin && status === 1 && !parsed.file) {
          return notFoundError(parsed.original, syscall);
      }
  
      return null;
  }

• example usage

  n/a

module cross-spawn-async.spawn

function cross-spawn-async.spawn (command, args, options)

• description and source-code

  function spawn(command, args, options) {
      var parsed;
      var spawned;
  
      // Parse the arguments
      parsed = parse(command, args, options);
  
      // Spawn the child process
      spawned = cp.spawn(parsed.command, parsed.args, parsed.options);
  
      // Hook into child process "exit" event to emit an error if the command
      // does not exists, see: https://github.com/IndigoUnited/node-cross-spawn/issues/16
      enoent.hookChildProcess(spawned, parsed);
  
      return spawned;
  }

• example usage

  ...
      var parsed;
      var spawned;
  
      // Parse the arguments
      parsed = parse(command, args, options);
  
      // Spawn the child process
      spawned = cp.spawn(parsed.command, parsed.args, parsed.options);
  
      // Hook into child process "exit" event to emit an error if the command
      // does not exists, see: https://github.com/IndigoUnited/node-cross-spawn/issues/16
      enoent.hookChildProcess(spawned, parsed);
  
      return spawned;
  }
  ...

function cross-spawn-async.spawn._parse (command, args, options)

• description and source-code

  function parse(command, args, options) {
      var shebang;
      var applyQuotes;
      var file;
      var original;
  
      // Normalize arguments, similar to nodejs
      if (args && !Array.isArray(args)) {
          options = args;
          args = null;
      }
  
      args = args ? args.slice(0) : [];  // Clone array to avoid changing the original
      options = options || {};
      original = command;
  
      if (isWin) {
          // Detect & add support for shebangs
          file = resolveCommand(command);
          file = file || resolveCommand(command, true);
          shebang = file && readShebang(file);
  
          if (shebang) {
              args.unshift(file);
              command = shebang;
          }
  
          // Escape command & arguments
          applyQuotes = command !== 'echo';  // Do not quote arguments for the special "echo" command
          command = escapeCommand(command);
          args = args.map(function (arg) {
              return escapeArg(arg, applyQuotes);
          });
  
          // Use cmd.exe
          args = ['/s', '/c', '"' + command + (args.length ? ' ' + args.join(' ') : '') + '"'];
          command = process.env.comspec || 'cmd.exe';
  
          // Tell node's spawn that the arguments are already escaped
          options.windowsVerbatimArguments = true;
      }
  
      return {
          command: command,
          args: args,
          options: options,
          file: file,
          original: original,
      };
  }

• example usage

  n/a