Playwright 1.62 发布满一个月了,不少团队还停在 1.5x 没动。不是更新少,是这次 changelog 塞得太满:新的组件测试模型、AbortSignal、WebP 快照、隔离重试,最要紧的是官方把 MCP Server 和 playwright-cli 直接打进了主包。把官方发布说明、文档和社区最近的讨论翻了一遍,说说谁该立刻升、谁该缓一缓、谁得先改代码。
最重要的变化:MCP 和 CLI 从「另装」变「内置」
1.62 开始多了两条命令:`npx playwright mcp` 和 `npx playwright cli`。Playwright 官方发布说明也就是说装 Playwright 的同时,MCP Server 和给 Agent 用的命令行工具就顺带装好了。以前想把 Playwright 接进 Claude Code 或 Codex,要单独装 @playwright/mcp 再配客户端;现在一条 npx 直接跑,入门成本几乎归零。
还要注意,这个 CLI 不是 MCP 换个壳。官方文档把分工写得很清楚:CLI 面向 Claude Code、Copilot 这类编码型 Agent,走 shell 命令 + 快照文件的路线,token 消耗更低,默认 headless;MCP 面向专门化的 Agent 循环和探索式自动化,默认 headed。Playwright 官方文档一句话选型:Agent 主业是写代码、顺手开浏览器验证 UI,选 CLI;做以浏览器为主角的自动化流程,选 MCP。真正跑起来,终端里的输出干净利落:Running 6 tests using 5 workers,用例数、通过数、总耗时一行说完。

这波 AI + Playwright 是真的热起来了。B 站上 Codex、Claude Code 配 Playwright 的教程成了测试号的流量题材。小红书上教 playwright cli 安装步骤的笔记收藏量已经破百,想上手的人远比讨论的人多。小红书
这三类人别急着升,先改这些
第一类:组件测试用户。 1.62 把组件测试正式切到 stories/galleries 新模型:mount() 不再接 JSX,而是接 story ID,需要自己准备 gallery 页面和 story 导出。老的 experimental-ct-* 包还在发版,但官方文档已经给出逐条迁移对照表——意味着旧路线被替代了。这次迁移是实打实的工作量,这个迭代没时间的话,缓一缓更稳。
第二类:CI 跑在 Debian 11 上的。 1.62 明确不再支持 Debian 11,先升镜像再升包,顺序搞反会被抓个正着。
第三类:用例里用了剪贴板的。 headless 模式下剪贴板现在和宿主机完全隔离。Playwright 官方发布说明这是安全修复——以前用例里的 navigator.clipboard 能读写跑测试那台机器的系统剪贴板——但如果你的用例有依赖读取系统剪贴板内容的断言逻辑,升级后行为会变,先排查再升。
四个值得立刻上主线的更新
retryStrategy: ‘isolated’。 7 月社区最集中的痛点就是「为什么本地稳、上 CI 就不稳」。知乎默认重试是 immediate,一有 worker 空闲就插进去重跑,和别的用例抢资源;‘isolated’ 把所有失败重试挪到最后,由单个 worker 逐个跑。被 CI flakiness 折磨的团队,冲这一个选项就值得升。
AbortSignal 支持。 大多数操作和 web-first 断言现在能接 signal 参数,长耗时导航、等待可以从外部取消(传 timeout: 0 仍是关掉超时)。写清理逻辑、并发逻辑时多了一层掌控。
WebP 快照。 toHaveScreenshot() 命名成 .webp,黄金图就存为无损 WebP。Playwright 官方发布说明Google 官方数据一直说无损 WebP 比 PNG 小 26% 左右,快照上千的项目,仓库体积和 CI 传输会肉眼可见地瘦。
HTML 报告 mergeFiles。 多分片并行跑用例时,每个分片各出一份报告,以前只能手动拼;1.62 把原来报告页里的 Merge files 开关变成了配置项,一个 mergeFiles: true 就能把多份结果聚合成一份完整 HTML 报告:顶部 All、Passed、Failed、Flaky 总数一字排开,下面按 spec 文件逐行列出各浏览器跑出的结果,跨分片排障不用再开好几个报告页来回切。Playwright 官方发布说明

还有几个小而好用的:WebAuthn passkeys 能进 storageState(passkey 流程不用每次完整登录)、locator.waitForFunction()、apiResponse.timing() 拿资源计时、reporter.preprocess() 让报告器决定跳过哪些用例。
结论:分组升级建议
纯 E2E 用户:直接上 1.62.1(7 月 30 日的补丁版),风险低,重试和 WebP 快照立刻能用。
组件测试用户:先排迁移,或者干脆停在老版本,别把升级和迁移塞进同一次发布。
AI Agent 玩家:升到 1.62 后先用 npx playwright cli / mcp 试水;追新功能的话注意独立包 @playwright/mcp 更新节奏更快(已经到 0.0.79,几乎天天出 alpha),值得单独装。
值得继续盯的信号:1.63 的首个 alpha 今天已有构建,CLI 还在 0.1.x 快速迭代,打算把流程建在 CLI 上的,把版本钉住,别追 latest 盲升。