Node.js / 系统课时

编写单元测试

编写单元测试

单元测试要把一小块业务逻辑放进可重复的输入与断言中,失败时能直接指出哪条规则被破坏。这里用 Node.js 内置测试运行器测试纯函数和服务层,并通过依赖注入替代真实库存系统,让测试不依赖网络、数据库或执行顺序。

学习目标

  • 使用 node:test 与 node:assert/strict 编写可重复执行的单元测试。
  • 为纯函数覆盖正常输入、边界输入和异常输入。
  • 用假的依赖替代数据库或远程服务,单独验证服务层决策。

用输入和输出固定业务规则

下面把订单金额计算与库存预留放在同一个业务模块中。calculateTotal() 只根据参数计算结果;createOrderService() 则把库存查询作为依赖传入,因此测试时可以替换为内存中的假对象,而不需要连接真实库存服务。

将下面内容保存为 order.mjs:

js
export function calculateTotal(items) {
  // 把输入合法性放在纯函数边界,失败规则也能被单测固定。
  if (!Array.isArray(items) || items.length === 0) {
    throw new TypeError('items must be a non-empty array');
  }

  return items.reduce((sum, item) => {
    // 金额规则只依赖参数,不读取时间、网络或数据库。
    return sum + item.price * item.qty;
  }, 0);
}

export function createOrderService({ inventory }) {
  return {
    async reserve(items) {
      const unavailable = [];

      for (const item of items) {
        // 外部库存能力由调用者注入,测试可以替换成内存假对象。
        const hasStock = await inventory.hasStock(item.sku, item.qty);
        if (!hasStock) unavailable.push(item.sku);
      }

      if (unavailable.length > 0) {
        return { ok: false, unavailable };
      }

      return { ok: true, total: calculateTotal(items) };
    }
  };
}

预期结果:保存 order.mjs 不会产生控制台输出;它只导出 calculateTotal() 与 createOrderService(),由测试文件导入后验证。

这个模块把“金额算法”和“库存是否可用”分开:测试金额时不需要库存,测试库存决策时只需要控制 hasStock() 的返回值。真实项目里,数据库连接对象、HTTP 客户端和消息队列发布器都适合用同样方式从外部传入。

覆盖正常路径与失败边界

将测试保存为同目录的 order.test.mjs。第一条测试验证带数字的计算结果;第二条用假库存服务制造缺货;第三条固定空数组必须抛出 TypeError 的边界规则。测试数据都写在文件内,每次执行得到相同结果。

js
import test from 'node:test';
import assert from 'node:assert/strict';
import { calculateTotal, createOrderService } from './order.mjs';

test('calculateTotal sums price times quantity', () => {
  // 用具体数字固定金额规则:20×2 + 14×2 = 68。
  const total = calculateTotal([
    { sku: 'A-1', price: 20, qty: 2 },
    { sku: 'B-2', price: 14, qty: 2 }
  ]);

  assert.strictEqual(total, 68);
});

test('reserve reports unavailable SKUs without real I/O', async () => {
  const calls = [];
  // fake 既控制返回值,也记录服务层传给依赖的参数。
  const inventory = {
    async hasStock(sku, qty) {
      calls.push({ sku, qty });
      return sku !== 'B-2';
    }
  };

  const service = createOrderService({ inventory });
  const result = await service.reserve([
    { sku: 'A-1', price: 20, qty: 1 },
    { sku: 'B-2', price: 14, qty: 1 }
  ]);

  assert.deepStrictEqual(result, { ok: false, unavailable: ['B-2'] });
  assert.deepStrictEqual(calls, [
    { sku: 'A-1', qty: 1 },
    { sku: 'B-2', qty: 1 }
  ]);
});

test('calculateTotal rejects an empty order', () => {
  // 异常类型和消息也是可观察到的业务边界。
  assert.throws(
    () => calculateTotal([]),
    { name: 'TypeError', message: 'items must be a non-empty array' }
  );
});

预期结果:保存 order.test.mjs 后会得到 3 条测试定义;真正执行时,三条断言都应通过,且不会访问真实库存系统。

这里不要只断言“返回了一个对象”。deepStrictEqual() 应固定业务真正关心的字段,例如缺货 SKU;throws() 则固定错误类型和消息。若以后规则改为允许空订单,这条失败测试会明确提醒你同步修改规格,而不是悄悄改变行为。

运行测试并读取失败信息

在两个文件所在目录执行测试。显式指定 TAP reporter,可以让不同终端中的关键结果更稳定,适合本地验证和 CI 日志收集。

bash
node --test --test-reporter=tap order.test.mjs

预期输出(关键行;耗时等动态值可能不同):

text
TAP version 13
# Subtest: calculateTotal sums price times quantity
ok 1 - calculateTotal sums price times quantity
# Subtest: reserve reports unavailable SKUs without real I/O
ok 2 - reserve reports unavailable SKUs without real I/O
# Subtest: calculateTotal rejects an empty order
ok 3 - calculateTotal rejects an empty order
1..3
# tests 3
# pass 3
# fail 0

若要确认测试确实能抓到回归,可以暂时把 calculateTotal() 中的乘法改成加法并再次执行,第一条测试应失败;验证后立即撤销改动。一个有价值的单元测试必须既能在正确实现上通过,也能在被刻意破坏的实现上失败。

保持测试可重复

单元测试优先使用固定输入,不直接读取当前时间、随机数、网络和真实数据库。若业务必须依赖这些值,把 clock.now()、random.next() 或 repository.find() 作为依赖注入,再在测试里传入固定实现;这样同一测试在本机、CI 和不同执行顺序下都能得到相同结论。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

编写单元测试

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通