Node.js如何实现不阻塞进程退出的setTimeout超时警告逻辑

开发需初始化的Node.js库时，采用setTimeout实现未初始化告警：5秒内未调用setup()函数就弹出警告。但该实现存在问题：所有业务代码执行完毕后，进程会等待该setTimeout执行完成，额外多等5秒才退出。
期望效果：仅当setup()未被调用、且程序本身持续运行满5秒未退出时才触发警告，告警逻辑本身不能阻塞进程正常退出。
原有实现代码：

const done = new Event(); // 自定义的一次性事件多播类

function setup() {
  done.emit();
}

const timeoutHandle = setTimeout(() => showWarning(), 5000);
done.subscribe(() => {
  clearTimeout(timeoutHandle);
});

console.log("The program should end here");

// 执行到最后一行后程序仍会等待5秒才退出

使用Node.js原生API即可实现，无需引入第三方依赖，核心是调用定时器的unref()方法：

const done = new Event(); // 自定义的一次性事件多播类

function setup() {
  done.emit();
}

const timeoutHandle = setTimeout(() => showWarning(), 5000);
timeoutHandle.unref(); // 关键配置：标记该定时器不阻塞进程退出
done.subscribe(() => {
  clearTimeout(timeoutHandle);
});

console.log("The program should end here");
// 此时所有业务任务执行完后进程会直接退出，不会额外等待告警定时器

逻辑说明 #

• unref()是Node.js中定时器、套接字等异步句柄的原生方法，作用是告知事件循环：不要因为等待该句柄的任务执行而保持进程运行。
• 该方案完全匹配需求：
  • 如果程序本身有其他活跃任务（比如HTTP服务、长连接、业务定时器等）保持进程持续运行，满5秒且未调用setup()时，警告会正常触发。
  • 如果业务代码执行完毕后没有其他待执行任务，进程会直接退出，不会被告警定时器阻塞。
• 如果后续需要恢复该定时器对进程的阻塞能力，调用timeoutHandle.ref()即可还原默认行为。
• 注意该API仅Node.js环境提供，浏览器环境的setTimeout无此方法，适配Node.js库场景完全可用。

内容的提问来源于stack exchange，提问作者anut