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 的关键约束。

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

目录与阅读设置

阅读设置

17

记录一个想法

测试 TypeScript 代码

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

登录哪都通