信号事件 | Node.js API 文档

🌐 Signal events

当 Node.js 进程收到信号时，将会发出信号事件。请参阅 signal(7) 以查看标准 POSIX 信号名称的列表，例如 'SIGINT'、'SIGHUP' 等。

🌐 Signal events will be emitted when the Node.js process receives a signal. Please refer to signal(7) for a listing of standard POSIX signal names such as 'SIGINT', 'SIGHUP', etc.

Worker 线程上没有信号。

🌐 Signals are not available on Worker threads.

信号处理程序将接收信号的名称（如 'SIGINT'、'SIGTERM' 等）作为第一个参数。

🌐 The signal handler will receive the signal's name ('SIGINT', 'SIGTERM', etc.) as the first argument.

每个事件的名称将是信号的常用大写名称（例如，SIGINT 信号对应 'SIGINT'）。

🌐 The name of each event will be the uppercase common name for the signal (e.g. 'SIGINT' for SIGINT signals).

import process from 'node:process';

// Begin reading from stdin so the process does not exit.
process.stdin.resume();

process.on('SIGINT', () => {
  console.log('Received SIGINT. Press Control-D to exit.');
});

// Using a single function to handle multiple signals
function handle(signal) {
  console.log(`Received ${signal}`);
}

process.on('SIGINT', handle);
process.on('SIGTERM', handle);const process = require('node:process');

// Begin reading from stdin so the process does not exit.
process.stdin.resume();

process.on('SIGINT', () => {
  console.log('Received SIGINT. Press Control-D to exit.');
});

// Using a single function to handle multiple signals
function handle(signal) {
  console.log(`Received ${signal}`);
}

process.on('SIGINT', handle);
process.on('SIGTERM', handle);

'SIGUSR1' 被 Node.js 保留用来启动调试器。可以安装一个监听器，但这样做可能会干扰调试器。
'SIGTERM' 和 'SIGINT' 在非 Windows 平台上有默认处理程序，它们会在退出时以代码 128 + 信号编号 重置终端模式。如果给其中一个信号安装了监听器，其默认行为将被移除（Node.js 将不再退出）。
默认情况下会忽略 'SIGPIPE'。可以为其安装监听器。
在 Windows 上，当控制台窗口关闭时会生成 'SIGHUP'，在其他平台下也会在各种类似情况下生成。请参见 signal(7)。可以安装监听器，但是 Windows 会在大约 10 秒后无条件终止 Node.js。在非 Windows 平台上，SIGHUP 的默认行为是终止 Node.js，但一旦安装了监听器，其默认行为将被移除。
'SIGTERM' 在 Windows 上不受支持，但可以监听它。
来自终端的 'SIGINT' 在所有平台上都受支持，通常可以通过 Ctrl+C 生成（尽管这可能是可配置的）。当启用终端原始模式并使用 Ctrl+C 时，它不会被生成。
'SIGBREAK' 在 Windows 上会在按下 Ctrl+Break 时触发。在非 Windows 平台上，可以监听它，但没有办法发送或生成它。
'SIGWINCH' 会在控制台尺寸改变时发送。在 Windows 上，这只会在控制台写入时发生，前提是光标正在移动，或者在使用原始模式的可读 tty 时发生。
'SIGKILL' 无法安装监听器，它将在所有平台上无条件终止 Node.js。
'SIGSTOP' 不能安装监听器。
'SIGBUS'、'SIGFPE'、'SIGSEGV' 和 'SIGILL'，当不是通过 kill(2) 人为触发时，本质上会使进程处于一个不安全的状态，此时调用 JS 监听器是不安全的。这样做可能会导致进程停止响应。
0 可以用于测试进程是否存在，如果进程存在则不会有任何作用，但如果进程不存在则会抛出错误。

Windows 不支持信号，因此没有与信号终止相对应的功能，但 Node.js 提供了一些通过 process.kill() 的模拟，以及 subprocess.kill()：

🌐 Windows does not support signals so has no equivalent to termination by signal, but Node.js offers some emulation with process.kill(), and subprocess.kill():

发送 SIGINT、SIGTERM 和 SIGKILL 会导致目标进程被无条件终止，之后，subprocess 将报告该进程已被信号终止。
发送信号 0 可作为一种平台无关的方法来测试进程是否存在。