Files
cad-world/frontend/tests
2026-09-24 17:20:27 +08:00
..
2026-09-22 10:36:28 +08:00
2026-09-24 17:20:27 +08:00
2026-09-22 10:36:28 +08:00
2026-09-24 17:20:27 +08:00
2026-09-22 10:36:28 +08:00
2026-09-22 10:36:28 +08:00
2026-09-22 10:36:28 +08:00
2026-09-24 17:20:27 +08:00
2026-09-22 10:36:28 +08:00
2026-09-22 10:36:28 +08:00
2026-09-22 10:36:28 +08:00

CAD World 测试约定

分层策略

  • 单元测试放在源码旁的 __tests__,只验证单模块规则。
  • 集成测试统一放在 tests/integration,验证真实模块协作。
  • E2E 放在 tests/e2e,只覆盖高价值用户闭环。
  • 当前阶段不做组件测试,避免把业务规则重复写成高维护成本的 UI 断言。

命名规范

  • 单元测试:*.unit.spec.ts
  • 集成测试:*.integration.spec.ts
  • E2E:*.e2e.spec.ts
  • 依赖 DOM 的 Vitest 文件使用 *.dom.spec.ts

目录约定

  • tests/factories/:构造合法业务对象,避免手写复杂字面量。
  • tests/fakes/:端口替身与轻量可运行实现。
  • tests/helpers/:断言、fixture 读取、语义归一化工具。
  • tests/fixtures/:导入导出样例、golden 文本、稳定测试数据。

编写原则

  • 优先断言业务行为和不变量,不断言私有实现细节。
  • 优先用真实 domain/application 代码,少用 vi.mock()。
  • 复杂对象必须优先使用 factory,不要在测试里拼大型 JSON/对象图。
  • 导入导出优先使用语义比较;只有 canonical 文本才允许 golden 比较。
  • 新增测试必须回答一个明确风险问题,例如“命令是否可对称 undo/redo”。

Review Checklist

  • 测试是否放在正确层级,而不是跨层重复覆盖。
  • 是否使用了已有 factory / fake / helper,而不是手写对象。
  • 是否断言外部行为,而不是耦合内部实现。
  • 是否避免了随机时间、随机 ID、真实网络、真实浏览器副作用。
  • 若更新 golden/fixture,是否说明了语义变化而非仅刷新输出。