JavaScript / TypeScript / 系统课时
测试 TypeScript 代码
测试 TypeScript 代码
类型检查能发现静态错误,但不能证明业务结果正确。本课使用 Vitest 测试订单函数,并把运行时测试与独立的类型检查组合到同一验证流程中。
学习目标
- 编写针对纯函数的单元测试
- 区分运行时测试与 TypeScript 类型检查
- 为成功、失败和边界情况建立测试用例
准备测试环境
安装依赖:
bash
npm install --save-dev typescript vitest在 package.json 中加入脚本:
json
{
"scripts": {
"typecheck": "tsc --noEmit",
"test": "vitest run",
"verify": "npm run typecheck && npm run test"
}
}Vitest 可以直接转换 TypeScript 测试文件,但测试运行本身不等于完整类型检查,因此仍应单独执行 tsc --noEmit。:contentReference[oaicite:7]{index=7}
编写待测函数
src/calculateDiscount.ts:
ts
export type CustomerLevel = "normal" | "vip";
export function calculateDiscount(
amountInCents: number,
level: CustomerLevel
): number {
if (!Number.isInteger(amountInCents) || amountInCents {
it("keeps the original amount for normal customers", () => {
expect(calculateDiscount(1000, "normal")).toBe(1000);
});
it("applies a ten percent discount for vip customers", () => {
expect(calculateDiscount(1000, "vip")).toBe(900);
});
it("rejects negative amounts", () => {
expect(() => calculateDiscount(-1, "vip")).toThrow(
"amountInCents must be a non-negative integer"
);
});
});执行:
bash
npm run verify预期输出
text
> tsc --noEmit
> vitest run
Test Files 1 passed
Tests 3 passed实际输出可能包含版本、耗时和路径等动态信息,但关键结果应是类型检查无错误且三个测试全部通过。
测试关键边界
一个有效测试通常只验证一个行为。优先覆盖:
- 正常输入与主要业务分支
- 边界值,例如
0 - 明确拒绝的非法输入
- 曾经出现过的缺陷
不要只追求覆盖率数字。测试名称应说明输入条件和期望行为,失败时才能快速定位。
验证类型行为
运行时测试无法证明 "gold" 会被编译器拒绝,类型检查可以:
ts
import { calculateDiscount } from "./calculateDiscount";
// @ts-expect-error "gold" 不是合法客户等级
calculateDiscount(1000, "gold");@ts-expect-error 适合验证某行必须产生类型错误;若未来该行不再报错,编译器会反过来提示该指令未被使用。此类检查应少量用于公共 API 的关键约束。
按自己的节奏,确认真正理解。