用途:在真实浏览器中驱动运行中的应用,证明某个流程可用。多数情况下只需当场走一遍流程并报告所见结果,无需安装或写文件;只有少数值得反复运行的流程才保存为测试。
主要能力与用法:默认行为是启动应用、像真人一样点击走完流程、逐步报告发生了什么并明确说明是否通过。覆盖新表单、注册、应显示刚创建内容的页面等,无需 spec 文件、运行器或下载浏览器。
何时保存测试:仅当流程在本冲刺剩余时间内值得反复运行时。优先核心动作、付费路径(结账、升级等任何收费环节)以及曾经出过错的东西,整个冲刺上限约三个 spec,文件名按用户行为命名,如 can-create-a-project.spec.ts。
安装取舍:Playwright 会下载真实浏览器,体积达数百 MB 且需数分钟,安装前应先说明并确认值得。若时间紧可先手动走流程,之后再提供安装。安装时取最小集:@playwright/test、仅 Chromium、一份配置、一个 spec,不加额外 reporter、CI 接线或其他浏览器。
登录处理:绝不自动化 Google 登录页,自动化浏览器会被 Google 拦截,失败现象会误导为应用故障。应提前决定:创建可直接登录的测试用户(邮件链接、仅开发路由或预置会话),登录一次后将浏览器会话存入 storageState 文件,之后每个测试从该文件开始即为已登录。若某项目认证确实无法脚本化,应尽早说明并让所有保存的测试停留在未登录界面。
部署后验证:推送上线后打开生产 URL,执行核心动作并截图,这能发现本地存在而 Vercel 缺失的环境变量问题。若生产失败但本地通过,应明确指出通常是配置而非代码问题。
可存活一个冲刺的写法:用 getByRole、getByLabel、getByText 等按人找元素的方式,避免 CSS 链或 Tailwind 类名;用 Playwright 自带断言,不用 waitForTimeout;每个 spec 一条端到端路径;断言用户能看到的结果;出现一次不稳定当天修掉或删除。
限制:不做视觉回归快照、不做跨浏览器矩阵、不设覆盖率目标、不测试上述短名单之外的任何内容。资料未提供具体价格与平台支持信息。