# @agent-inspect/jest 中文文档

规范地址：https://npmcn.com/package/%40agent-inspect/jest/

版本：6\.31\.35
npm 元数据更新时间：2026-11-04T20:01:34.949Z
中文译文更新时间：2026-11-06T12:52:23.695Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40agent-inspect/jest
原文对照：https://npmcn.com/package/%40agent-inspect/jest/?lang=original
项目主页：https://github.com/rajudandigam/agent-inspect/tree/main/packages/jest
源码仓库：https://github.com/rajudandigam/agent-inspect

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

- 包体积（解压后）：181 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：jest ^29\.0\.0 \|\| ^30\.0\.0
- 首次发布：2026-06-28T04:39:16.189Z
- 最新版本发布：2026-11-04T20:01:34.565Z
- 近 30 天下载量：3181（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：122（近 12 个月 122 个）

## 中文简介

Jest记者和实验 Trace Contracts配对员 本地证据

## 安装

```sh
npm install @agent-inspect/jest
```

也可以使用：`pnpm add @agent-inspect/jest`、`yarn add @agent-inspect/jest`、`bun add @agent-inspect/jest`

## README

# @ agent-incont/ 夹击

本地特工的杰斯特记者 检查失败文物,加 **实验** 追踪合同匹配者.

**支助级别:** · 实验(匹配)——见 [支助](https://github.com/rajudandigam/agent-inspect/blob/main/docs/SUPPORT-LEVELS.md)。网络行为 : [网络-银行](https://github.com/rajudandigam/agent-inspect/blob/main/docs/NETWORK-BEHAVIOR.md)。 。 。 .

## 何时使用

-   与特工检查仪器代理的测试套房
-   CI 失败证据与本地 Jest 输出

## 不使用时

-   测试(使用) `@agent-inspect/vitest`(中文(简体) )

## 安装

```bash
npm install agent-inspect @agent-inspect/jest jest
```

**端点 :** `jest@^29.0.0 || ^30.0.0` (可选元)

## 示例

```js
// jest.config.js
const { AgentInspectJestReporter } = require("@agent-inspect/jest");

module.exports = {
  reporters: [
    "default",
    [AgentInspectJestReporter, { artifactDir: ".agent-inspect/jest-artifacts" }],
  ],
};
```

## 追踪关联

这个记者 **没有** 利用时间戳创建协会. 没有关联的测试失败 产生一个 `no-trace-association` 诊断 (和范围 `no-trace-association.md` 而不是沉默无声.

将测试与当地追踪联系起来,其中一项是:

```js
const { withAgentInspectJestTrace } = require("@agent-inspect/jest");

// 1) Helper metadata on the assertion result
expect.extend({
  /* your matcher can attach: */
  ...withAgentInspectJestTrace({
    runId: "run_abc",
    tracePath: ".agent-inspect/run_abc.jsonl",
  }),
});

// 2) Reporter options
[
  AgentInspectJestReporter,
  {
    associations: {
      "agent.test.js::does the thing": {
        runId: "run_abc",
        tracePath: ".agent-inspect/run_abc.jsonl",
      },
    },
    // or resolveTrace: (test) => ({ runId, tracePath })
  },
];
```

## 隐私

-   关于失败的本地文件; 代理检查没有网络

## API 密码

-   `createAgentInspectJestReporter` 编号 : `AgentInspectJestReporter`
-   `withAgentInspectJestTrace` • 明确的关联帮助器(不自动捕获)
-   `agentInspectJestMatchers` - 实验性(`toPassTraceContract`, (中文(简体) ), `toHaveRequiredTool`(中文(简体) )

## 国 际

`npx agent-inspect report` 上传的 CI 文物

## 限制

-   初级表面为a **记者** (故障文物)加 **实验** 选手.
-   实验匹配器:

```js
const { expect } = require("@jest/globals");
const { agentInspectJestMatchers } = require("@agent-inspect/jest");

expect.extend(agentInspectJestMatchers);

expect(read).toPassTraceContract(contract);
expect(read).toHaveRequiredTool("lookup_orders");
```

-   没有 `expectTrace(...).toSatisfyTraceContract` 帮手.
-   使用 `agent-inspect check` / 火柴不足时深 CI 门的跟踪合同API.

## 文档

-   [CI 文物](https://github.com/rajudandigam/agent-inspect/blob/main/docs/CI-ARTIFACTS.md)
-   [TRACE-COTRACTS.md (美国)](https://github.com/rajudandigam/agent-inspect/blob/main/docs/TRACE-CONTRACTS.md)

## 解决问题

-   **未装入的记者 :** 检查杰斯特 `reporters` 您 Jest 版本的数组语法

## 版本

部分固定代理监取放行. 参见当前版本的npm徽章/包表.

## 许可证

麻省理工学院

## 常见问题

### @agent-inspect/jest 是什么？

Jest记者和实验 Trace Contracts配对员 本地证据

### 如何安装 @agent-inspect/jest？

在项目目录运行 npm install @agent-inspect/jest，或使用 pnpm add / yarn add / bun add。

### @agent-inspect/jest 支持 TypeScript 吗？

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

### @agent-inspect/jest 支持 ESM 还是 CommonJS？

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

### @agent-inspect/jest 可以商用吗？

@agent-inspect/jest 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @agent-inspect/jest 的下载量有多少？

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

### @agent-inspect/jest 还在维护吗？

最新版本 6\.31\.35 发布于 2026/11/05（3 天前）；至今共发布 122 个版本，其中过去 12 个月发布了 122 个；首次发布于 2026/06/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。