Skip to main content
On this page

处理操作系统信号

⚠️ Windows 支持监听 SIGINTSIGBREAKSIGTERMSIGQUITSIGHUPSIGWINCH(除 SIGINT/SIGBREAK 外,其余都通过 libuv 的 Windows 信号仿真机制)。

概念 Jump to heading

设置操作系统信号监听器 Jump to heading

处理操作系统信号的 API 是基于已经熟悉的 addEventListenerremoveEventListener API 模型化的。

⚠️ 请注意,监听操作系统信号并不会阻止事件循环完成,即如果没有其他挂起的异步操作,进程将退出。

你可以使用 Deno.addSignalListener() 函数来处理操作系统信号:

add_signal_listener.ts
console.log("按 Ctrl-C 触发 SIGINT 信号");

Deno.addSignalListener("SIGINT", () => {
  console.log("被中断!");
  Deno.exit();
});

// 添加一个超时以防止进程立即退出。
setTimeout(() => {}, 5000);

运行命令:

deno run add_signal_listener.ts

你可以使用 Deno.removeSignalListener() 函数注销之前添加的信号处理程序。

signal_listeners.ts
console.log("按 Ctrl-C 触发 SIGINT 信号");

const sigIntHandler = () => {
  console.log("被中断!");
  Deno.exit();
};
Deno.addSignalListener("SIGINT", sigIntHandler);

// 添加一个超时以防止进程立即退出。
setTimeout(() => {}, 5000);

// 在 1 秒后停止监听信号。
setTimeout(() => {
  Deno.removeSignalListener("SIGINT", sigIntHandler);
}, 1000);

运行命令:

deno run signal_listeners.ts

Windows 支持 Jump to heading

受支持的信号集合因平台而异。Windows 上的特定行为如下:

Use case Supported signals on Windows
Deno.addSignalListener(sig, …) SIGINT, SIGBREAK, SIGTERM, SIGQUIT, SIGHUP, SIGWINCH
Deno.kill(pid, sig) SIGINT, SIGBREAK, SIGTERM, SIGQUIT, SIGHUP, SIGWINCH, SIGKILL, SIGABRT, plus signal 0 for a process-health check

SIGKILLSIGABRT 故意不能通过 addSignalListener 注册——它们是不可捕获/致命的,这与 Unix 语义一致。在 Windows 上,可捕获的信号都会转发到 libuv 的仿真层;通过 Deno.kill 发送的信号最终会调用 TerminateProcess

Last updated on

Did you find what you needed?

编辑此页面
Privacy policy