JavaScript测试与调试技巧全解析

本文深入解析了现代 JavaScript 单元测试的核心实践与调试精髓：从 Vitest 与 Jest 的选型策略（新项目首选轻快原生的 Vitest，旧项目延续 Jest 生态），到编写真正可测函数的关键原则（隔离副作用、避免隐式状态变更、规范异步处理）；从 VS Code 中高效断点调试的实操配置（文件识别、断点设置、sourceMap 排查），再到 mock 失败的根源剖析与可靠写法（模块加载时机、vi.useFakeTimers 同步启用、mock 返回结构精准匹配）。无论你是刚起步的测试新手，还是正被脆弱测试困扰的资深开发者，这里都有直击痛点的解决方案和开箱即用的最佳实践。

怎么选 Jest 还是 Vitest 做 JavaScript 单元测试

绝大多数新项目直接用 Vitest 更轻、更快，尤其搭配 Vite 项目时开箱即用；Jest 适合已有大型代码库、依赖其生态（如 jest-circus 自定义 runner 或大量 ts-jest 配置）的团队。

关键差异点：

• Vitest 默认支持 ESM、顶层 await 和原生 TypeScript（无需额外编译），Jest 默认仍走 CommonJS，需配 ts-jest 或 babel-jest
• describe/it 语法一致，但 Vitest 的 vi.mock() 行为更接近 Node.js 模块机制，而 Jest 的 jest.mock() 是静态提升的，容易在条件判断中失效
• 调试时 Vitest 可直接用 VS Code 的 Debug 按钮启动（识别 vitest.config.ts），Jest 需额外配置 .vscode/launch.json 并指定 runtimeExecutable

如何写真正可测的函数，避开常见陷阱

不是所有函数都适合单元测试——核心是「可隔离」和「可预测」。以下写法会让测试变脆弱：

• 函数内部调用 Date.now()、Math.random()、localStorage 等副作用源，应提取为参数或依赖注入（例如传入 clock: { now: () => number }）
• 直接修改传入对象（如 obj.name = 'new'），导致测试间状态污染；改用返回新对象（{ ...obj, name: 'new' }）或明确标注 mutate: true 选项
• 用 setTimeout 做“异步”但没返回 Promise，导致 await 失效；必须显式 return new Promise(...) 或改用 Promise.resolve().then(...)

示例：错误写法 → 正确写法

// ❌ 不可测
function fetchUser(id) {
  return fetch(`/api/users/${id}`).then(r => r.json());
}

// ✅ 可测：依赖抽象化
function fetchUser(id, apiClient = fetch) {
  return apiClient(`/api/users/${id}`).then(r => r.json());
}

VS Code 调试 JavaScript 测试用例的实操要点

不靠 console.log，真断点调试才能看清执行流。重点在三件事：

• 确保测试文件后缀是 .test.ts 或 .spec.ts（Vitest 默认识别），且未被 exclude 在 vitest.config.ts 中
• 在测试代码里打上断点（比如 expect(...).toBe(...) 前一行），右键选择 Debug Test（Vitest）或运行带 --runInBand --no-cache 的 Jest 命令
• 若断点不命中，检查是否启用了 sourceMap: true（Vite/Vitest 默认开启），并确认 devtools: true 在 vitest.config.ts 的 browser 或 coverage 配置中未被误关

常见报错：Cannot set breakpoints in file ... because it does not map to any source file —— 通常是 tsconfig.json 中 "outDir" 和 "sourceRoot" 冲突，删掉 outDir 即可（Vitest 不需要编译输出）

mock 接口请求时为什么总是 mock 失败

根本原因不是语法错，而是模块加载时机与 mock 注入顺序不匹配。典型失败场景：

• 被测模块在顶层就 import 了 axios，而 vi.mock('axios') 写在测试文件底部 → mock 生效前模块已初始化完成
• 用 vi.mock 但没调用 vi.useFakeTimers()，导致 axios 内部的 setTimeout 跳过，请求永远 pending
• mock 返回值写成 mockResolvedValue({ data: {...} })，但实际代码里是 response.data → 应该 mock 成 { data: { id: 1 } }，而非只 mock data 字段

可靠写法：

import { vi, it, expect } from 'vitest';
import { getUser } from './api';

vi.mock('./api', async (importOriginal) => {
  const mod = await importOriginal();
  return {
    ...mod,
    axios: {
      get: vi.fn().mockResolvedValue({ data: { id: 1, name: 'Alice' } })
    }
  };
});

it('fetches user by id', async () => {
  const user = await getUser(1);
  expect(user.id).toBe(1);
});

注意：mock 必须放在 import 语句之后、测试用例之前，且不能包裹在 it 或 beforeEach 里。

今天关于《JavaScript测试与调试技巧全解析》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！