用途:为 Positron 编写符合既定约定的 Playwright 端到端测试,覆盖新建测试文件、向已有文件添加用例、调试不稳定或失败测试、理解测试 fixture 系统、使用页面对象,以及选择正确的选择器与断言。核心理念是只保留能可靠保护目标用户可见行为的最小测试,避免因易写而多加场景或断言。好测试应验证可观察的用户行为而非实现细节,覆盖完整工作流,最小化准备,保持确定性(不依赖固定等待、执行顺序或残留状态),并隔离单一回归点。
主要能力与约定:每个测试文件必须从 ../_test.setup 导入 test、expect、tags(只导入用到的),并设置 test.use({ suiteId: __filename });用 test.describe 的 tag 数组标注平台与功能标签,无平台标签时仅在 Linux/Electron 运行,可加 tags.WEB / tags.WIN。UI 交互走 app.workbench.* 页面对象而非原始 locator,方法名须从 test/e2e/pages/.ts 源码复制,不得猜测。断言默认 15 秒超时,不要习惯性覆盖。性能/指标测试放在对应功能的 performance/ 子目录,使用 metric. 包装器,且必须带 tags.PERFORMANCE;计时器内只放触发动作与等待完成,避免在计时器内调用含固定延迟的 POM 方法(如 sendEnterKey() 含 waitForTimeout(500))。常见错误包括导入错误、缺 suiteId、缺平台标签、反射式加超时、缺少 test.step()、用 page.waitForTimeout 代替 web-first 断言等。
使用方式:可先阅读 test/e2e/tests/<feature>/ 下的邻近测试再动笔。运行示例:npx playwright test <test-name>.test.ts --project e2e-electron;按类别运行 npx playwright test test/e2e/tests/<category>/;按标签运行 npx playwright test --grep @:critical;调试可用 --headed 或 --debug;查看报告用 npx playwright show-report。不稳定测试可参考 e2e-failure-analyzer 脚本查询历史,或由用户自行运行 /triage-e2e-test。
限制与未提供信息:资料未说明安装方式、收费或价格、支持平台明细及具体版本要求,暂未提供。