如何编写可测试且易于维护的JavaScript单元测试?

答案:编写可测试的JavaScript代码需遵循纯函数、避免全局状态、依赖注入和单一职责原则。例如,将时间等外部依赖作为参数传入,使函数输出可预测,便于断言和隔离测试。

编写可测试且易于维护的JavaScript单元测试,关键在于代码结构清晰、职责分离、依赖可控以及测试用例简洁明确。以下是一些实用策略和最佳实践。

1. 编写可测试的代码

测试的难易程度往往取决于被测代码本身的设计。如果函数逻辑复杂、副作用多、依赖外部状态,测试就会变得困难。

建议做法:

  • 使用纯函数:输入相同,输出始终一致,没有副作用,便于断言。
  • 避免全局状态:不要依赖或修改全局变量,否则测试之间会相互影响。
  • 依赖注入:将外部依赖(如API调用、时间、随机数)作为参数传入,而不是在函数内部硬编码。
  • 单一职责:每个函数只做一件事,这样测试用例更聚焦,更容易理解。
例如,不要这样写:
function getGreeting() {
  const hour = new Date().getHours();
  if (hour < 12) return "Good morning";
  return "Hello";
}
而是改为可注入时间:
function getGreeting(now) {
  const hour = now.getHours();
  if (hour < 12) return "Good morning";
  return "Hello";
}

这样你就可以在测试中传入任意时间进行验证。

2. 使用合适的测试框架和工具

选择主流、社区活跃的测试工具能显著提升开发效率和维护性。

推荐组合:

  • Jest:开箱即用,支持快照、Mock、覆盖率报告,适合大多数项目。
  • Vitest:与Vite集成良好,速度快,适合现代前端项目。
  • Mocha + Chai + Sinon:更灵活,适合需要自定义配置的场景。

统一测试风格和断言方式,团队协作时更易维护。

3. 编写清晰、独立的测试用例

每个测试应只验证一个行为,命名清晰,不依赖其他测试的执行顺序。

注意点:

  • 使用描述性强的it()test()标题,比如should return greeting based on morning time
  • 每个测试只关注一个路径或边界条件。
  • 使用beforeEachafterEach隔离共享逻辑,避免状态污染。
  • 避免过度使用describe嵌套,保持结构扁平易读。

4. 合理使用Mock和Spy

对外部依赖(如API、定时器、DOM操作)进行模拟,确保测试快速且稳定。

常见场景:

  • jest.mock('./api')模拟模块返回值。
  • jest.spyOn(console, 'error')验证错误是否被正确处理。
  • 模拟Date.now()setTimeout以控制时间相关逻辑。

但不要滥用Mock——过度模拟会让测试变得脆弱,难以反映真实行为。

基本上就这些。写出可维护的测试,核心是让代码可拆分、可预测,测试本身也要像产品代码一样注重质量。不复杂,但容易忽略细节。