| name | e2e-webantd-realapi |
| description | MallBase Vben Admin 局部格式化与真实后端 E2E 收口规则;修改、测试或回归 web-antd 代码时使用。 |
Vben 规则:局部格式化与真实后端 E2E
适用场景
frontend/admin/apps/web-antd/** 页面、路由、API 调用改动
- 需要验证前端是否真实打通后端接口(非 playground mock)
强制规则
- 修改
web-antd 代码后必须先对本次改动文件做局部格式化,不默认格式化整个前端 monorepo。
- 默认使用
web-antd 作为 E2E 主入口,不以 playground 或 mock 结果替代真实业务回归。
- 登录类用例必须校验真实接口请求与响应,而不是只校验页面跳转。
- 失败时必须区分 UI 操作、网络、CORS、环境配置、账号密码和业务断言问题。
局部格式化
优先对本次改动文件执行:
pnpm --dir frontend/admin exec eslint --fix <web-antd改动文件...>
不受 ESLint 处理的文件再补:
pnpm --dir frontend/admin exec prettier --write <目标文件...>
禁止默认执行 pnpm --dir frontend/admin format,避免带出 apps/web-antd 之外的大量无关差异。格式化后必须复查 diff,确认没有扩散修改。
E2E 标准命令
pnpm --dir frontend/admin run test:e2e:install
pnpm --dir frontend/admin run test:e2e
首次执行先安装 Playwright 浏览器;默认脚本已指向 @vben/web-antd。纯文案或无行为变化的样式调整可按风险执行相关页面抽样验证,但必须说明未跑全量 E2E 的理由。
用例落地约束
- 用例目录:
frontend/admin/apps/web-antd/__tests__/e2e/
- 登录页使用
?e2e=1 进入测试模式(用于跳过滑块等非核心链路阻塞)
- 对登录请求至少断言:
- 请求路径包含
/auth/admin/login
- 响应存在且可读
- 业务码
code === 200
最小交付格式(测试角色)
- 已执行的格式化、测试命令
- 通过数/失败数
- 首个失败摘要(如失败)
- 未执行项目及原因
- 需要开发配合项(如 CORS、环境变量、账号)