SuperAPI AI 工具集

app-validation

测试与质量

查看项目

更新于 10-16 06:47

技能介绍

用途:本技能用于验证该模板应用在浏览器中的实际运行效果,必须与 playwright-cli 技能配合使用。playwright-cli 只覆盖工具本身命令,本技能补充该模板特有的验证规则。应用只能通过 Fabric 门户嵌入流程测试,禁止直接对 localhost 测试。

主要能力与检查项:验证 UI 元素正确渲染且可见;文本符合无障碍标准;应用无控制台错误(需忽略 Fabric 门户自身噪声);视觉一致性检查,包括关键布局容器的 padding 与 gap 非零、卡片背景与描边颜色、图表轴标签与数据标签颜色一致、分组柱状图不出现自动注入的数据标签、图表渲染高度健康(低于约 100px 可疑、低于约 50px 可能被压扁)、同一工具栏中控件字体属性一致等。

使用方式:先做预检,确认 .env.local 与 .env.fabric 中 VITE_FABRIC_PORTAL_URL、VITE_FABRIC_WORKSPACE_ID、VITE_FABRIC_ITEM_ID 齐全,缺失时用 npx rayfin up --workspace-uri "<target-workspace-uri>" 配置。随后在独立终端运行 npm run dev 启动 Vite,再运行 npm run test:fabric 打开 Fabric 浏览器会话。该命令只打开会话,不负责配置后端、启动开发服务器或执行检查。后续用 playwright-cli -s=fabric 命令检查嵌入应用帧。

性能与鉴权规则:所有 playwright-cli 调用使用 initial_wait: 1;首次打开 Fabric 门户嵌入 URL 时用 initial_wait: 30。不要与 token/鉴权提示页交互,应在 run-code 中通过 sessionStorage.setItem 注入令牌并用 page.route() 模拟 API 响应后 page.reload();真实 AAD 重定向则使用 --persistent 配置让用户登录一次。除非用户明确要求,否则不截图,改用 snapshot 验证。

限制:npm run test:fabric 仅打开浏览器会话;应用需三层 iframe 加载;若被 LNA 拦截需确认传入 --config=.playwright-config.json。控制台错误只统计来源与嵌入应用服务器同源的错误。规范文件应与被测文件同目录,纯工具函数和查询工厂函数建议编写测试,不得为覆盖率而写测试,也不得用模拟或硬编码数据代替真实查询结果。