SuperAPI AI 工具集

playwright-e2e

测试与质量

查看项目

更新于 10-15 17:29

技能介绍

用途:为自有 Web 应用编写完整的 Playwright 端到端测试脚本,而不是通过 MCP 工具交互式导航。其思路来自 Armin Ronacher 与 Mario Zechner,主张对自家应用采用代码生成而非交互式工具调用。

项目初始化:mkdir e2e && cd e2e;npm init -y;npm install @playwright/test;npx playwright install chromium。配置文件 playwright.config.js 可通过 defineConfig 设置 testDir、testMatch、timeout,以及 webServer 自动启动后端、reuseExistingServer、仅在失败时保留 screenshot 与 trace。可在 Makefile 中加 test-e2e 目标执行 npx playwright test。

主要能力:提供认证绕过模式,在开发模式(如未设置 SMTP_HOST)时于 API 响应直接返回 token 与 verify_url,测试提取后访问校验地址;提供 JWT 辅助函数,用 crypto 生成 HS256 token 测试受保护的管理端接口;演示测试结构模式,如 beforeEach 重置状态、混用 request 与 page、一个测试覆盖完整用户旅程、对非 UI 逻辑使用纯 API 测试。

适用场景:Web 应用 e2e 测试搭建、认证流程测试、浏览器自动化脚本,以及管理与导出等接口的 API 级测试。

限制与坑点:npm 包不含浏览器二进制,安装后必须运行 npx playwright install chromium;reuseExistingServer 会复用端口上已有服务,需先清理旧进程;Cookie 按 context 而非按 page 隔离;不要用 MCP 工具测试自家应用;截图开销大,仅在失败时截图;DB_PATH 为 :memory: 时同一服务实例会跨测试复用,需用 beforeEach 重置状态。资料未提供具体实现语言之外的更多平台与收费信息。