Node.js ChildProcess subprocess.kill([signal])用法及代碼示例

subprocess.kill([signal])

參數

• signal <number> | <string>
• 返回： <boolean>

subprocess.kill() 方法向子進程發送信號。如果沒有給出參數，進程將被發送'SIGTERM' 信號。有關可用信號的列表，請參閱 signal(7) 。如果 kill(2) 成功，此函數返回true，否則返回false。

const { spawn } = require('node:child_process');
const grep = spawn('grep', ['ssh']);

grep.on('close', (code, signal) => {
  console.log(
    `child process terminated due to receipt of signal ${signal}`);
});

// Send SIGHUP to process.
grep.kill('SIGHUP');

如果無法傳遞信號， ChildProcess 對象可能會發出 'error' 事件。向已經退出的子進程發送信號不是錯誤，但可能會產生無法預料的後果。具體來說，如果進程標識符 (PID) 已重新分配給另一個進程，則信號將被傳遞給該進程，而這可能會產生意想不到的結果。

雖然該函數被稱為 kill ，但傳遞給子進程的信號實際上可能不會終止該進程。

請參閱 kill(2) 以供參考。

在不存在 POSIX 信號的 Windows 上，signal 參數將被忽略，進程將被強製而突然地終止(類似於 'SIGKILL' )。有關詳細信息，請參閱Signal Events。

在 Linux 上，子進程的子進程在試圖殺死其父進程時不會被終止。在 shell 中運行新進程或使用 ChildProcess 的 shell 選項時，可能會發生這種情況：

'use strict';
const { spawn } = require('node:child_process');

const subprocess = spawn(
  'sh',
  [
    '-c',
    `node -e "setInterval(() => {
      console.log(process.pid, 'is alive')
    }, 500);"`,
  ], {
    stdio: ['inherit', 'inherit', 'inherit']
  }
);

setTimeout(() => {
  subprocess.kill(); // Does not terminate the Node.js process in the shell.
}, 2000);