@haatlabs-core/queue

中文文档
0.18.5发布于 2026/11/14Apache-2.0TypeScriptESM + CJS近 30 天下载 5643

BullMQ在Redis上的工作队列:发布者,重试消费者和出箱接力.

中文使用文档
文档目录3 节
  1. 安装
  2. 投票时没有工人名额
  3. 延迟和不再重复的出版物

@haatlabs-core/队列

BullMQ工作队列在 Redis 上: 出版者,重试消费者(带有优先道)和 收发箱中继器 一个项目提供它的地貌,意思是它的队列名称,路由键 每个前缀及其键前缀通过自己的 connectQueue数字 :

const route = routeByPrefix<QueueName>({ 'shopify-sync': ['shopify.'], imports: ['import.'] });
export const connectQueue = (url: string, options: { prefix?: string } = {}) =>
  connect(url, { prefix: options.prefix ?? 'shop:queue', route });

ioredis是一种同伴依赖.

@haatlabs-core/queue/contracts (0.12.1) (中文(简体) ) QUEUE_ERRORS, (中文(简体) ), QueueErrorCode, (中文(简体) ), createQueueError 编辑 QueueError 类型,没有节点:项目的合同,其页面加载,从这里导入,永不取根,用于节点.

安装

pnpm add @haatlabs-core/queue

它给你的应用程序留下了一个软件包,所以该应用程序持有一个副本: ioredis。 。 。 .

投票时没有工人名额

一个在外部(批量操作、媒体处理)电话上等待的处理器 pollAgain(message, { delayMs, deadlineMs, state, onDeadline })。工作被放回一个 延迟工作,同时其工人空档期,保持其尝试数和路径,以及 message.poll (单位:千美元)round, (中文(简体) ), startedAt, (中文(简体) ), deadlineAt, (中文(简体) ), state在下一轮.

  • delayMs 每回合250至15分钟。 每一次民意测验都有截止时间 设定在第一轮 (b) 回合可以缩短,永远不能延长。 一旦它来了 通过了, onDeadline() 任务失败.
  • 每轮再次从上方运行操作器. 之前的作品 pollAgain 必须是 双能或分支 message.poll.state。 。 。 .
  • state 最多为 16 KiB 的 JSON; 更多为 a RangeError。 。 。 .
  • onDeadline()'错误决定接下来会发生什么: 短暂的失败尝试和 重新尝试重新开始流动( 民意调查被清除) ; 永久状态会保留失败 。 A 类 PollAgain 直接超过最后期限时失败, 因为 POLL_TIMED_OUT (单位:千美元)QUEUE_ERRORS, (中文(简体) ), 这是短暂的.
  • RestartPoll 尝试失败 短暂 并清除民意调查, 所以重试重新开始.
  • 在调试时记录投票结果 queue.process 横跨结束为结果 poll,而不是作为 错误.

延迟和不再重复的出版物

publish(key, payload, { delayMs, deduplication: { id } }) 将信件延后,或连接到 发布共享 ID。 工作持有ID直到它完成或永远失败:

  • 等待它的第一个运行( 延迟或不) , 后期的发布被删除 : 任务没有 开始,所以它会看到新的状态;
  • 运行时,更新的后期发布在完成或失败时保存并排队;
  • 又被耽搁了 PollAgain 圆或复试的后退,后一发布为 丢弃, (中文(简体) ), 虽然这份工作已经读到了国家.

所以请用 deduplication 只有那些从不调查 和从头到尾的处理者 尝试。 消费者警告说,一旦民意调查,工作调查就会中断.

这种出版物是直接的,从不通过发包箱:发包行带不 delayMs 没有 deduplication。如果进程在承诺和发布之间死亡,则信息会丢失. 需要它生存下来的呼叫者 通过发件箱,没有他们, 和联合起来 处理器代替.

失败的工作保留每队1000个,持续14天.

版本与发布记录

@haatlabs-core/queue 共发布 27 个版本,首次发布于 2026/10/23;过去 12 个月发布了 27 个版本。

版本发布日期距今
0.18.5latest2026/11/143 天前
0.18.42026/11/133 天前
0.18.32026/11/134 天前
0.18.22026/11/134 天前
0.18.12026/11/134 天前
0.18.02026/11/134 天前

关于 @haatlabs-core/queue 的常见问题

@haatlabs-core/queue 是什么?

BullMQ在Redis上的工作队列:发布者,重试消费者和出箱接力.

如何安装 @haatlabs-core/queue?

在项目目录运行 npm install @haatlabs-core/queue,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:ioredis(^6.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@haatlabs-core/queue 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@haatlabs-core/queue 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@haatlabs-core/queue 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=24。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@haatlabs-core/queue 可以商用吗?

@haatlabs-core/queue 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@haatlabs-core/queue 的下载量有多少?

根据 npm 官方下载统计,@haatlabs-core/queue 在 2026/10/17 – 2026/11/15 这 30 天内被下载 5,643 次,日均约 188 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@haatlabs-core/queue 还在维护吗?

最新版本 0.18.5 发布于 2026/11/14(3 天前);至今共发布 27 个版本,其中过去 12 个月发布了 27 个;首次发布于 2026/10/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。