AI Agent / 系统课时
生成与维护测试
生成与维护测试
本课围绕一个分页参数函数建立可维护的自动化测试。你将让 Codex先识别公开行为,再分别覆盖正常路径、边界条件和异常输入,最后用稳定断言验证结果,而不是只追求测试数量。
学习目标
- 从函数契约中提取必要测试场景
- 使用 Node.js 内置测试框架编写可运行测试
- 避免脆弱断言和重复测试造成维护负担
先定义被测行为
测试生成质量取决于契约是否明确。对 normalizePage 而言,规则只有三条:页码和每页数量必须是整数;页码至少为 1;每页数量限制在 1 到 100。先把这些规则告诉 Codex,再让它提出测试矩阵。
js
// pagination.mjs
export function normalizePage(page, pageSize) {
if (!Number.isInteger(page) || !Number.isInteger(pageSize)) {
throw new TypeError("page and pageSize must be integers");
}
if (page < 1 || pageSize < 1 || pageSize > 100) {
throw new RangeError("page or pageSize is out of range");
}
return {
offset: (page - 1) * pageSize,
limit: pageSize
};
}这是完整模块。配置文件或接口定义本身不产生控制台输出,生效行为将在测试中验证。
设计最小测试矩阵
三个维度已经足够覆盖本例的主要风险:
| 类型 | 输入 | 应验证的行为 |
|---|---|---|
| 正常路径 | page=3, pageSize=20 |
返回 offset=40, limit=20 |
| 边界条件 | 最小页码、最大每页数量 | 边界值被接受且计算正确 |
| 异常行为 | 小数、零、超过 100 | 抛出正确错误类型 |
不要让 Codex为每个普通数字生成一个近似测试。测试应代表不同规则,而不是重复证明同一件事。
编写可运行测试
下面使用 Node.js 内置的 node:test,无需额外测试依赖。将文件与 pagination.mjs 放在同一目录。
js
// pagination.test.mjs
import test from "node:test";
import assert from "node:assert/strict";
import { normalizePage } from "./pagination.mjs";
test("calculates offset for a normal page", () => {
assert.deepEqual(normalizePage(3, 20), { offset: 40, limit: 20 });
});
test("accepts the minimum page number", () => {
assert.deepEqual(normalizePage(1, 10), { offset: 0, limit: 10 });
});
test("accepts the maximum page size", () => {
assert.deepEqual(normalizePage(2, 100), { offset: 100, limit: 100 });
});
test("rejects non-integer input", () => {
assert.throws(() => normalizePage(1.5, 20), TypeError);
});
test("rejects out-of-range input", () => {
assert.throws(() => normalizePage(1, 101), RangeError);
});运行测试:
bash
node --test pagination.test.mjs预期结果如下,耗时和展示格式会随 Node.js 版本变化:
text
tests 5
pass 5
fail 0让测试保持稳定
可靠测试只观察公开结果,不依赖内部变量名、执行次数或日志文本。若重构实现后返回值和异常契约没有变化,测试就不应失败。对于时间、随机数、网络和数据库等不稳定依赖,应先注入可控替身,再让 Codex生成测试。
新增测试时还要检查是否重复覆盖旧场景。可以让 Codex先列出“现有测试已经证明什么”,再补缺口;不要直接要求“提高覆盖率”,否则容易得到大量价值有限的断言。
验证测试确实能捕获问题
测试全绿并不证明测试有效。可暂时把偏移公式改成 page * pageSize,确认正常路径测试会失败,再恢复正确实现。这种故意制造错误的检查只在本地完成,不应提交到仓库。
bash
node --test pagination.test.mjs错误实现下的预期结果应包含至少一个失败:
text
tests 5
pass 4
fail 1恢复实现后再次运行,结果应回到 5 个通过。
按自己的节奏,确认真正理解。