从 Jest 迁移

大多数 Jest 测试套件都可以迁移到 deno test，而无需重写测试逻辑：node:test 模块提供了相同的 describe/it 结构，标准库也提供了带有你已在使用的匹配器的 expect。变化之处主要是少量导入方式以及运行器的配置方式。

在 Deno 中运行相同的测试 Jump to heading#

一个典型的 Jest 测试只需要新的导入：

import { beforeEach, describe, it } from "node:test";
import { expect, fn } from "jsr:@std/expect";

describe("shopping cart", () => {
  let cart: string[];

  beforeEach(() => {
    cart = [];
  });

  it("starts empty", () => {
    expect(cart).toHaveLength(0);
  });

  it("notifies a listener", () => {
    const onAdd = fn();
    cart.push("apple");
    onAdd(cart.length);
    expect(onAdd).toHaveBeenCalledWith(1);
  });
});

$ deno test cart.test.ts
ok | 1 passed (2 steps) | 0 failed (13ms)

与 Jest 不同，没有任何内容会作为全局变量注入：describe、it、expect 和这些钩子都是显式导入的，因此每个文件都会明确表明自己使用了什么。针对 node:test 编写的测试也可以在 Node.js 本身中继续运行。

一一对应关系 Jump to heading#

翻译配置 Jump to heading#

Jest 配置大多会直接消失：TypeScript、JSX 和 ES 模块无需转换即可工作，因此 ts-jest、babel-jest 和 transform 条目没有对应项可迁移。文件选择迁移到 deno.json 中：

{
  "test": {
    "include": ["src/**/*.test.ts"],
    "exclude": ["src/fixtures/"]
  }
}

模块模拟 Jump to heading#

没有 jest.mock("./module") 的对应功能，因为 Deno 中的模块记录是不可变的。依赖它的测试通常会迁移为以下其中一种方式：

• 依赖注入：将协作者传入，并为测试提供一个 spy 或 stub；
• 使用 @std/testing/mock 中的 stub 来替换模块对外暴露的对象。

这通常是迁移中唯一需要修改被测代码的部分。

尽可能保留 npm 包 Jump to heading#

来自 npm 的测试辅助工具仍可通过 npm: 规范符继续使用，例如用于 DOM 断言的 npm:@testing-library/dom（参见 将 Testing Library 与 Deno 一起使用）。真正需要迁移的是测试运行器本身。

关于运行器标志、报告器和覆盖率，请参阅 deno test 参考。