Function runCmdBackground

src/utils/exec.ts:359–422

(
  cmd: string,
  args: string[],
  options: ExecBackgroundOptions = {},
)

}

export function runCmdBackground(
  cmd: string,
  args: string[],
  options: ExecBackgroundOptions = {},
): ExecBackgroundResult {
  const executable = normalizeExecutableCommand(cmd);
  const execTrace = createExecTraceContext();
  const child = spawn(executable, args, {
    cwd: options.cwd,
    env: options.env,
    stdio: options.stdio ?? ['ignore', 'pipe', 'pipe'],
    detached: options.detached,
    windowsHide: true,
    shell: false,
  });
  execTrace.emitBackgroundSpawn(cmd, args);

  let stdout = '';
  let stderr = '';
  const captureOutput = options.captureOutput ?? true;
  const abort = watchCommandAbort(child, options);

  if (captureOutput) {
    child.stdout?.setEncoding('utf8');
    child.stderr?.setEncoding('utf8');

    child.stdout?.on('data', (chunk) => {
      stdout += chunk;
    });
    child.stderr?.on('data', (chunk) => {
      stderr += chunk;
    });
  }

  const wait = new Promise<ExecResult>((resolve, reject) => {
    child.on('error', (err) => {
      abort.dispose();
      execTrace.emitBackgroundCompletion(cmd, args, 'error');
      reject(spawnRejectionError(abort, executable, cmd, args, err));
    });
    child.on('close', (code) => {
      abort.dispose();
      execTrace.emitBackgroundCompletion(cmd, args, 'exit');
      const exitCode = code ?? 1;
      const failure = commandCloseFailure(
        abort,
        executable,
        cmd,
        args,
        exitCode,
        options.allowFailure,
        stdout,
        stderr,
      );
      if (failure) {
        reject(failure);
        return;
      }