SuperAPI AI 工具集

testing

测试与质量

查看项目

更新于 10-16 09:46

技能介绍

用途:为 Elements 组件编写与运行自动化测试,覆盖单元、无障碍、视觉、SSR 和 Lighthouse 五类测试。适合在创建组件测试文件(.test.ts、.test.axe.ts、.test.visual.ts、.test.ssr.ts、.test.lighthouse.ts)、调试测试失败、更新既有测试、理解 @internals/testing 工具、配置测试环境或 HTML 模板,以及按项目模式编写测试时使用。

主要能力与用法:改动测试前必须先阅读 @projects/site/src/docs/internal/guidelines/testing.md。按测试类型查阅对应指南:单元测试读 testing-unit.md,涉及 createFixture、elementIsStable、事件测试;无障碍测试读 testing-accessibility.md,涉及 axe-core 与 WCAG 合规;视觉测试读 testing-visual.md,涉及 Playwright 截图与主题测试;SSR 测试读 testing-ssr.md,涉及服务端渲染兼容;Lighthouse 测试读 testing-lighthouse.md,涉及性能与无障碍评分。

关键原则:测试相互隔离,用 createFixture 和 removeFixture 完成 setup/teardown;对 Lit 组件断言前先用 elementIsStable() 等待稳定;新组件至少需要单元、无障碍和视觉测试;用 emulateClick 和 untilEvent 模拟真实用户事件;视觉测试覆盖亮色与暗色两种主题。

限制:资料未提供安装命令、具体 API 参数、版本要求或运行命令示例;实际执行需结合项目内部指南与 Vite 相关配置。