测试 node:test

这一课你将能做到

1. 用 Node 20 内置的 node:test 写出单元测试并运行，全程零第三方依赖
2. 使用 assert 断言普通值、抛错（assert.throws）和异步拒绝（assert.rejects）
3. 用 describe/it 组织用例，测异步函数，并跑出覆盖率报告

为什么要学

没有测试的代码，改一行就要「凭感觉」上线——感觉是不可靠的。测试人话：把「我改完应该还能跑」变成「机器跑一遍用例确认还能跑」，重构、升级依赖、接手别人代码时全靠它兜底。

Node 20 把测试框架 node:test 升为稳定内置模块：不用装 Jest/Mocha，node --test 一条命令就能跑。小工具、脚本、库项目用它完全够；理解了它的概念（用例、断言、夹具、覆盖率），换 Jest 等框架也只是换语法外壳。

先建立图像

一个测试文件的结构（AAA 模式）：

test('用例描述', () => {
  // Arrange 准备：造输入数据
  // Act     执行：调用被测函数
  // Assert  断言：assert.strictEqual(实际, 期望)
});

运行链路：
  node --test            → 扫描 test/ 目录（或 *.test.js）→ 逐个执行 → 汇总报告
  ✓ 用例通过（绿）  ✗ 断言失败（红，显示实际 vs 期望）

测试的本质就一句话：用代码描述「给定什么输入、期望什么输出」，让机器反复验证。

跟着做

步骤 1：写一个被测模块

新建 node-test 目录，npm init -y，新建 math.js：

// math.js
function add(a, b) {
  return a + b;
}

function divide(a, b) {
  if (b === 0) {
    throw new RangeError('除数不能为 0');
  }
  return a / b;
}

async function sumRemote(values) {
  // 模拟一个异步计算（现实中可能是查库/请求）
  await new Promise((r) => setTimeout(r, 10));
  return values.reduce((s, n) => s + n, 0);
}

module.exports = { add, divide, sumRemote };

步骤 2：第一个测试文件

按约定新建 test/math.test.js（或与源文件同级叫 math.test.js，node --test 都认）：

// test/math.test.js
const test = require('node:test');
const assert = require('node:assert');
const { add, divide } = require('../math');

test('add 两数相加', () => {
  assert.strictEqual(add(1, 2), 3);
});

test('add 处理负数', () => {
  assert.strictEqual(add(-1, -2), -3);
});

test('divide 正常相除', () => {
  assert.strictEqual(divide(10, 4), 2.5);
});

test('divide 除以 0 时抛 RangeError', () => {
  assert.throws(() => divide(1, 0), {
    name: 'RangeError',
    message: '除数不能为 0',
  });
});

运行：

node --test
# ▶ add 两数相加
#   ✔ 0ms
# ▶ divide 除以 0 时抛 RangeError
#   ✔ 1ms
# ℹ tests 4
# ℹ pass 4
# ℹ fail 0

零配置、零安装，直接出报告。把 npm test 接上（package.json scripts 默认的 test 值改掉）：