child_process.execFileSync(file[, args][, options])

• file <string> 要运行的可执行文件的名称或路径。
• args <string[]> 字符串参数列表。
• options <Object>
  • cwd <string> | <URL> 子进程的当前工作目录。
  • input <string> | <Buffer> | <TypedArray> | <DataView> 将作为标准输入传递给生成的进程的值。如果 stdio[0] 设置为 'pipe'，提供此值将覆盖 stdio[0]。
  • stdio <string> | <Array> 子进程的 stdio 配置。请参见 child_process.spawn() 的 stdio。默认情况下，stderr 将输出到父进程的 stderr，除非指定了 stdio。默认值: 'pipe'。
  • env <Object> 环境键值对。默认值： process.env。
  • uid <number> 设置进程的用户身份（参见 setuid(2)）。
  • gid <number> 设置进程的组标识（参见 setgid(2)）。
  • timeout <number> 进程允许运行的最长时间（毫秒）。默认值： undefined。
  • killSignal <string> | <integer> 在终止被生成的进程时使用的信号值。默认值： 'SIGTERM'。
  • maxBuffer <number> 允许在 stdout 或 stderr 上的最大字节数据量。如果超过此限制，子进程将被终止。请参阅 maxBuffer 和 Unicode 中的注意事项。默认值： 1024 * 1024。
  • encoding <string> 所有标准输入和输出使用的编码方式。 默认值: 'buffer'。
  • windowsHide <boolean> 隐藏通常在 Windows 系统上创建的子进程控制台窗口。默认值： false。
  • shell <boolean> | <string> 如果为 true，将在 shell 中运行 command。在 Unix 上使用 '/bin/sh'，在 Windows 上使用 process.env.ComSpec。可以通过字符串指定不同的 shell。参见 Shell 要求 和 默认 Windows shell。默认值: false（不使用 shell）。
• 返回：<Buffer> | <string> 命令的标准输出。

child_process.execFileSync() 方法通常与 child_process.execFile() 完全相同，唯一的区别是该方法在子进程完全关闭之前不会返回。当遇到超时并发送 killSignal 时，该方法不会返回，直到进程完全退出。

【The child_process.execFileSync() method is generally identical to child_process.execFile() with the exception that the method will not return until the child process has fully closed. When a timeout has been encountered and killSignal is sent, the method won't return until the process has completely exited.】

如果子进程拦截并处理 SIGTERM 信号且没有退出，父进程仍然会等待直到子进程退出。

【If the child process intercepts and handles the SIGTERM signal and does not exit, the parent process will still wait until the child process has exited.】

如果进程超时或有非零退出代码，此方法将抛出一个 Error，其中将包含底层 child_process.spawnSync() 的完整结果。

【If the process times out or has a non-zero exit code, this method will throw an Error that will include the full result of the underlying child_process.spawnSync().】

如果启用了 shell 选项，请不要将未经过滤的用户输入传递给此函数。任何包含 shell 元字符的输入都可能被用来触发任意命令的执行。

const { execFileSync } = require('node:child_process');

try {
  const stdout = execFileSync('my-script.sh', ['my-arg'], {
    // Capture stdout and stderr from child process. Overrides the
    // default behavior of streaming child stderr to the parent stderr
    stdio: 'pipe',

    // Use utf8 encoding for stdio pipes
    encoding: 'utf8',
  });

  console.log(stdout);
} catch (err) {
  if (err.code) {
    // Spawning child process failed
    console.error(err.code);
  } else {
    // Child was spawned but exited with non-zero exit code
    // Error contains any stdout and stderr from the child
    const { stdout, stderr } = err;

    console.error({ stdout, stderr });
  }
}import { execFileSync } from 'node:child_process';

try {
  const stdout = execFileSync('my-script.sh', ['my-arg'], {
    // Capture stdout and stderr from child process. Overrides the
    // default behavior of streaming child stderr to the parent stderr
    stdio: 'pipe',

    // Use utf8 encoding for stdio pipes
    encoding: 'utf8',
  });

  console.log(stdout);
} catch (err) {
  if (err.code) {
    // Spawning child process failed
    console.error(err.code);
  } else {
    // Child was spawned but exited with non-zero exit code
    // Error contains any stdout and stderr from the child
    const { stdout, stderr } = err;

    console.error({ stdout, stderr });
  }
}拷贝