Skip to content

自动化测试 ​

1. 测试分层 ​

工作区使用三层自动化验证:

  • Vitest + Happy DOM:验证纯函数、数据契约、路由元数据和组合式状态逻辑;
  • 组件消费冒烟构建:验证组件包安装、类型、样式入口和轻量入口 tree-shaking;
  • Playwright + Chromium:验证真实浏览器中的匿名重定向与 Mock 登录主链路。

单元测试放在 tests/unit,E2E 测试放在 tests/e2e。测试文件只依赖模板公开边界,避免断言组件内部 class、渲染层级或临时动画。

2. 常用命令 ​

bash
# 全部自动化测试
pnpm test

# 单元测试
pnpm test:unit

# 单元测试监听模式
pnpm test:unit:watch

# 组件包消费与 tree-shaking 冒烟验证
pnpm test:smoke

# 浏览器端到端测试
pnpm test:e2e

首次运行 E2E 前需要安装与当前 Playwright 版本匹配的 Chromium:

bash
pnpm --filter @kevairy/admin-template exec playwright install chromium

Playwright 会在测试期间自动启动 http://127.0.0.1:4173,完成后关闭临时服务。失败时的截图和 Trace 写入被 Git 忽略的 test-results。

3. 当前覆盖 ​

区域关键行为
搜索参数递归清理空值,保留 0 和 false,处理富文本占位内容
HTTP 契约字符串/数字响应码兼容,稳定重复请求键
搜索 Mock筛选、分页、排序、错误和请求中止
路由搜索表格元数据、隐藏详情路由菜单高亮
usePagedTable查询快照、分页、重置、多选、错误和最后响应生效
公共组件受控工具栏、搜索展开、错误状态与恢复动作
组件冒烟项目插件安装、类型、完整 CSS 与 1.5 KB 轻量核心产物
VitePress交互示例与组件文档的严格类型检查和生产构建
E2E登录重定向;搜索、分页、错误恢复、键盘、移动端和主题

4. 新功能测试要求 ​

新增通用能力时,应优先测试输入输出和用户行为:

  1. 纯转换逻辑放入独立函数并使用单元测试覆盖边界;
  2. 组合式函数验证状态变化、错误和并发,不锁定实现细节;
  3. 页面主链路才增加 E2E,避免把所有组合情况堆到浏览器测试;
  4. 修复缺陷时先增加可以复现问题的测试;
  5. 合并前运行 pnpm test、pnpm lint、pnpm lint:stylelint、pnpm typecheck 和 pnpm build。