Node.js 测试框架对比

常用 JavaScript/TypeScript 测试框架的横向对比与选型建议。快速参考——实践示例见各课程。

一、框架总览

二、核心差异矩阵

三、什么时候选哪个

四、API 签名速查

node:test + node:assert/strict

import { describe, it, before, after, beforeEach, afterEach } from 'node:test';
import assert from 'node:assert/strict';

describe('suite', () => {
  it('case', () => {
    assert.equal(actual, expected);
    assert.deepEqual(obj, other);
    assert.match(str, /regex/);
    assert.doesNotMatch(str, /bad/);
    assert.ok(truthy);
    assert.throws(() => fn());
  });
});

// 运行：node --test out/test.js
// TypeScript：node --import tsx --test src/test.ts

Vitest (Jest-compatible API)

import { describe, it, expect, vi, beforeEach } from 'vitest';

describe('suite', () => {
  it('case', () => {
    expect(actual).toBe(expected);
    expect(obj).toEqual(other);
    expect(str).toMatch(/regex/);
    expect(truthy).toBeTruthy();
    expect(() => fn()).toThrow();
  });
});

// Mock 示例
const mockFn = vi.fn().mockReturnValue(42);
vi.mock('fs', () => ({ readFileSync: vi.fn() }));

// 运行：npx vitest

Jest

// API 与 Vitest 几乎相同——替换 import 来源即可：
import { describe, it, expect, jest, beforeEach } from '@jest/globals';
// 或者不 import，依赖 Jest 的全局注入

const mockFn = jest.fn().mockReturnValue(42);
jest.mock('fs', () => ({ readFileSync: jest.fn() }));

// 运行：npx jest

五、速度基准参考

大致量级对比（200 个测试的套件，纯函数，无 I/O）——精确数字取决于具体项目，但相对关系稳定。

六、VS Code 扩展测试的特殊考量

VS Code 扩展测试有两个独特挑战：

6.1 Mock VS Code API

// 扩展代码中大量使用：
import * as vscode from 'vscode';
vscode.window.createStatusBarItem(...)
vscode.workspace.getConfiguration(...)

// 在测试中直接 import 'vscode' 会失败——
// vscode 模块只在 VS Code 扩展宿主进程中存在。
// 解决方案：mock 掉整个 vscode 模块。

Vitest 的 vi.mock() 最适合这个场景：

// __mocks__/vscode.ts
export const window = {
  createStatusBarItem: vi.fn(() => ({ show: vi.fn(), text: '' })),
  showInformationMessage: vi.fn(),
};
export const workspace = {
  getConfiguration: vi.fn(() => ({ get: vi.fn() })),
};

如果只用 node:test，你需要手写 stub 或引入 sinon——都比 vi.mock() 更啰嗦。

6.2 哪些测试不需要 mock

纯数据变换函数（getLatestTokenCount、decodeProjectPath、formatTokens）不碰 VS Code API——用 node:test + fixture 文件测试完全足够。这就是 Lesson 0007 选 node:test 的原因：在不需要 mock 的时候，零依赖是最优解。

七、迁移路径