// 优雅退出:收到终止信号时按注册顺序并行执行收尾函数,然后退出。 // // 用法:把「怎么把浏览器关干净」注册进来,主程序不用到处写信号处理。 // const stop = createStopHandler({ log }); // const unregister = stop.add(() => browser.kill()); // if (stop.stopping) return; // 主循环里轮询这个开关 // stop.request('q'); // 面板里按 q 也走同一条收尾路径 // // 收尾完成后会 closeLog() 并以 0 退出,所以主循环不用自己处理信号。 // // 各平台的信号差异(很重要,不然 Windows 上会「关不掉」): // Linux/macOS Ctrl+C = SIGINT,kill = SIGTERM,两者都能收 // Windows Ctrl+C = SIGINT(可用),Ctrl+Break = SIGBREAK,关闭控制台窗口 = SIGHUP // SIGTERM 根本收不到;用 taskkill /F 或任务管理器「结束任务」是 TerminateProcess, // 任何处理函数都不会执行 —— 那种情况只能靠下次启动时清理残留进程+锁文件。 import { closeLog, log as defaultLog } from './log.mjs'; /** 各平台实际可能收到的终止信号 */ const SIGNALS = process.platform === 'win32' ? ['SIGINT', 'SIGBREAK', 'SIGHUP'] : ['SIGINT', 'SIGTERM', 'SIGHUP']; /** * @param {{ log?: Function, onExit?: (code:number)=>void }} [opts] */ export function createStopHandler(opts = {}) { const say = opts.log || defaultLog; const exit = opts.onExit || ((code) => process.exit(code)); const cleaners = []; let stopping = false; let triggered = null; const run = async (signal) => { if (stopping) return; stopping = true; triggered = signal; say('收到 ' + signal + ',正在收尾…'); // 收尾函数并行跑,谁也挡不住谁(浏览器关不掉也要退) await Promise.allSettled(cleaners.map((fn) => { try { return Promise.resolve(fn()); } catch (e) { return Promise.reject(e); } })); closeLog(); exit(0); }; process.on('SIGINT', () => run('SIGINT')); process.on('SIGTERM', () => run('SIGTERM')); process.on('SIGBREAK', () => run('SIGBREAK')); // Windows:Ctrl+Break process.on('SIGHUP', () => run('SIGHUP')); // Windows:关闭控制台窗口 return { /** 注册一个收尾函数,返回取消注册的函数 */ add(fn) { cleaners.push(fn); return () => { const i = cleaners.indexOf(fn); if (i >= 0) cleaners.splice(i, 1); }; }, /** * 主动请求收尾(终端面板里按 q / Ctrl+C 走这里), * 与收到信号完全同一条路径:并行收尾 → closeLog → exit(0)。 */ request(reason) { run(reason || '面板退出'); }, get stopping() { return stopping; }, get signal() { return triggered; }, /** 本平台实际监听的信号列表(自检 / 日志里用) */ signals: SIGNALS, }; }