用途:在 Positron 项目中编写、调试和维护 Playwright 端到端测试,适用于新建测试文件、补充用例、排查不稳定或失败测试、理解 fixture 体系、使用页面对象以及选择正确的选择器与断言。
主要能力:说明测试文件的必备结构,包括从 ../_test.setup 导入、设置 suiteId: __filename 实现应用隔离、使用 function 语法以支持 fixture、添加平台与功能标签;列出可用 fixture(app、page、python、r、sessions、executeCode、openFile、hotKeys、settings);介绍通过 app.workbench.* 访问页面对象(如 console、variables、dataExplorer、plots、notebooks、sessions);给出断言与等待模式,如带 timeout 的 toBeVisible、toHaveCount 以及 toPass 重试模式;说明功能标签(CONSOLE、DATA_EXPLORER、NOTEBOOKS、PLOTS、VARIABLES、CRITICAL)与平台标签(WEB、WIN,默认仅 Linux/Electron)的过滤作用。
使用方式:按示例结构创建测试文件并添加标签;运行可用 npx playwright test <test-name>.test.ts --project e2e-electron 运行单个文件,或用 npx playwright test --grep @:critical 按标签运行,也可用 --headed、--debug 调试,用 npx playwright show-report 查看报告。
限制与注意:必须避免错误导入(应使用 ../_test.setup)、缺失 suiteId、使用箭头函数、遗漏平台标签;异步断言应加 timeout,复杂多步操作应包在 test.step() 中。详细内容可参考随附的 references 文档。未提供的功能、收费、价格或平台信息暂未说明。