本文介绍如何在 Node.js 环境中创建可取消的 Promise 延时任务，避免传统 setTimeout + Promise 组合无法中途终止的问题，并推荐使用内置的 node:timers/promises 模块及 AbortSignal 实现优雅取消。
本文介绍如何在 node.js 环境中创建可取消的 promise 延时任务，避免传统 `settimeout` + `promise` 组合无法中途终止的问题，并推荐使用内置的 `node:timers/promises` 模块及 `abortsignal` 实现优雅取消。
在 JavaScript 中，将 setTimeout 封装为 Promise（即“Promisification”）是一种常见做法，例如：
const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
delay(1000).then(() => console.log("Done"));
然而，这种写法存在一个根本性限制：Promise 一旦创建便不可外部取消。你无法通过 clearTimeout 取消它，因为原始定时器 ID 在 Promise 内部被封闭，外部无从获取。
要真正支持取消，关键在于将取消能力前置到 Promise 创建阶段——即在构造时就接受一个取消信号（AbortSignal），并在信号触发时主动拒绝 Promise。Node.js 从 v15.4.0 起已原生支持该模式，推荐直接使用 node:timers/promises 模块中的 setTimeout：
const { setTimeout } = require('node:timers/promises');
// 创建取消控制器
const ac = new AbortController();
const signal = ac.signal;
// 启动带取消能力的延时 Promise
setTimeout(1000, 'foobar', { signal })
.then(console.log) // 1 秒后输出 'foobar'
.catch((err) => {
if (err.name === 'AbortError') {
console.error('The timeout was aborted'); // 取消时捕获 AbortError
}
});
// 在任意时刻调用 abort() 即可中断延时
ac.abort(); // 此行将立即触发 catch 分支
✅ 优势说明：
- 无需手动管理 setTimeout ID 或封装 clearTimeout；
- 遵循 Web 平台标准的 AbortSignal 接口，与 fetch、ReadableStream 等 API 行为一致；
- 错误类型明确（AbortError），便于条件处理；
- 支持在 setTimeout 触发前任意时间点取消，无资源泄漏风险。
⚠️ 注意事项：
- 该 API 仅适用于 Node.js（v15.4+），浏览器环境暂不支持 node:timers/promises；
- 若需跨平台兼容，可借助第三方库（如 p-timeout）或自行实现基于 AbortSignal 的封装（参考 Stack Overflow 相关实现）；
- 不要尝试在 Promise .then() 或 .catch() 中“补救式取消”，真正的取消必须发生在 Promise pending 阶段。
总之，放弃“先 Promise 再想办法取消”的思路，转而采用声明式取消设计——让 AbortSignal 成为 Promise 构造逻辑的一部分，才是现代异步编程中处理可中断延时任务的最佳实践。
