delay工具5大实战场景网页抓取、限流请求、测试等待的终极组合拳【免费下载链接】delayDelay a promise a specified amount of time项目地址: https://gitcode.com/gh_mirrors/de/delaydelay是一个专用于 JavaScript/TypeScript 的 Promise 延迟工具库核心功能是「延迟一个 Promise 指定毫秒数后再执行后续代码」一行await delay(100)就能让程序优雅地暂停。它比原生setTimeout更强大支持无限时长突破 24.8 天上限、随机延迟区间、信号取消、提前清除等待是网页抓取、限流请求、测试等待三大高频场景的终极组合拳。小贴士如果你的项目只跑在 Node.js 20 上也可以用内置的import {setTimeout} from node:timers/promises实现简单等待但需要浏览器兼容或更多高级特性时delay依然是首选。快速上手一条命令安装 delay 并运行安装只需一条命令npm install delay基本用法非常简单导入后直接await即可import delay from delay; console.log(开始); await delay(1000); // 等待 1 秒 console.log(1 秒后执行到这里);库的核心实现位于index.jsTypeScript 类型定义在index.d.ts完整 API 说明见readme.md。场景一网页抓取的人为节奏控制反爬更友好批量抓取网页时如果请求像机关枪一样密集发出很容易被目标站点识别为爬虫并封禁 IP。delay提供的rangeDelay可以在最小和最大毫秒之间随机等待模拟真人浏览的不规则节奏import {rangeDelay} from delay; for (const url of urls) { await fetchPage(url); await rangeDelay(500, 2000); // 每页之间随机等 0.5~2 秒 }随机间隔让请求节奏更自然比固定间隔的delay(1000)更贴近真实用户行为抓取任务也更安全。这正是rangeDelay在官方文档中被特别推荐用于网页抓取的原因。场景二限流请求批量调用接口自动控速调用第三方 API 时很多服务都有速率限制例如「每分钟最多 60 次」。用delay就能把控速逻辑写得清清楚楚import delay from delay; const tasks [...Array(100)]; for (const task of tasks) { await callApi(task); await delay(1000); // 每秒最多 1 次100 个任务约 100 秒跑完 }相比手写setTimeout回调嵌套或自己拼队列await delay()的代码几乎是线性阅读的先调用、再等待、再调用——逻辑一目了然新人接手也零门槛。场景三测试等待让 flaky 测试告别超时误报写单元测试时经常遇到等 DOM 渲染完成等动画结束这类需求。这里有两个delay的杀手锏1. 用rangeDelay替代固定阈值官方文档明确建议断言方法耗时不超过 X这类测试在 CI 上可能因机器性能波动而误报。给断言留一个阈值区间会更稳import {rangeDelay} from delay; // 性能断言前随机等待 0~200ms避免 CI 环境抖动导致偶发失败 await rangeDelay(0, 200);2. 用clearDelay提前结束等待等待时间到了不一定非等不可。clearDelay可以随时终止一个尚未到期的延迟 Promise并立即以预设值结算让测试不必傻等import delay, {clearDelay} from delay; const p delay(5000, {value: done}); if (conditionMet) { clearDelay(p); // 条件已满足立刻继续不用等满 5 秒 } console.log(await p); // done项目的测试文件test.js中就包含can clear a delayed resolution、resolution can be aborted with an AbortSignal等用例可以直接参考这些写法。场景四取消与清理AbortSignal 让等待可以叫停有些等待必须能被打断比如用户点击了取消按钮。delay支持传入标准的AbortSignal一旦信号触发等待立即以AbortError失败退出import delay from delay; const controller new AbortController(); buttonCancel.onclick () controller.abort(); // 用户点取消 try { await delay(10000, {signal: controller.signal}); // 最多等 10 秒 } catch (error) { if (error.name AbortError) console.log(用户取消了立即返回); }配合value选项等待结束后还能直接拿到一个自定义结果省得再声明一次变量const result await delay(100, {value: }); console.log(result); // 场景五自定义计时器注入mock 时间也不破坏延迟逻辑自动化测试框架常常需要把全局定时器 mock 掉例如jest.useFakeTimers()但这会让普通setTimeout失效。delay提供了createDelay允许你注入自定义的setTimeout/clearTimeout实现得到一个隔离的延迟实例import {createDelay} from delay; const customDelay createDelay({setTimeout, clearTimeout}); const result await customDelay(100, {value: }); console.log(result); // 官方文档称这个 API 正是为即将全局 stub 定时器、但仍要用 delay 管理测试的场景准备的。delay 的 4 个核心 API 一览表API作用一句话场景delay(ms, options?)默认导出延迟指定毫秒后 resolve所有需要暂停一下的场景rangeDelay(min, max)在区间内随机延迟网页抓取、性能测试留阈值clearDelay(promise)立即结束并结算一个延迟 Promise条件已满足不必等满createDelay({setTimeout, clearTimeout})创建注入自定义计时器的实例测试中 mock 全局时间两个通用的options参数在所有 API 中都能用value等待结束时 Promise 结算的值可为任意类型包括0、null等假值signalAbortSignal信号触发时以AbortError提前中断。还有一个隐藏福利delay底层依赖unlimited-timeout因此没有原生setTimeout约 24.8 天的最大时长限制想await delay(86400000 * 30)等一个月也完全没问题。常见问题delay 会阻塞浏览器或 Node 吗不会。await delay()只是让当前异步函数挂起等待事件循环照常运转其他任务网络请求、UI 渲染不受影响。这也是它比while循环空转等待优雅得多的原因。写在最后小工具大场景delay整个库只有index.js一个入口文件却精准覆盖了异步开发中等待这件事的所有痛点定长等待、随机等待、提前结束、随时取消、计时器注入。无论你是在写爬虫脚本、批量调接口还是让测试少一点 flakyawait delay(...)都值得成为你的肌肉记忆。【免费下载链接】delayDelay a promise a specified amount of time项目地址: https://gitcode.com/gh_mirrors/de/delay创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考