# @haatlabs-core/queue 中文文档

规范地址：https://npmcn.com/package/%40haatlabs-core/queue/

版本：0\.18\.5
npm 元数据更新时间：2026-11-13T18:20:26.381Z
中文译文更新时间：2026-11-17T06:29:28.634Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40haatlabs-core/queue
原文对照：https://npmcn.com/package/%40haatlabs-core/queue/?lang=original
项目主页：https://haatlabs.shop/docs/packages/queue/
源码仓库：https://github.com/Haatlabs/haatlabs-platform

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：106 kB，44 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=24
- 运行依赖：5 个
- peer 依赖：ioredis ^6\.0\.0
- 首次发布：2026-10-22T23:23:51.863Z
- 最新版本发布：2026-11-13T18:20:26.150Z
- 近 30 天下载量：5643（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 27 个）

## 中文简介

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

## 安装

```sh
npm install @haatlabs-core/queue
```

也可以使用：`pnpm add @haatlabs-core/queue`、`yarn add @haatlabs-core/queue`、`bun add @haatlabs-core/queue`

## README

# @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 是什么？

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 和提交记录判断。

