Playwright — 完全开源(MIT),本地或在 CI 中免费运行。为 Chromium、Firefox、WebKit 提供可靠的端到端测试,内置自动等待、网络模拟、代码生成、追踪查看器、UI 模式;跨浏览器、跨平台、Node.js / Python / Java / .NET 绑定。
官方入口:https://playwright.dev | GitHub 66k+ Stars | 微软维护
本地/CI 自托管运行器永远免费,"云"才收费——Playwright 核心框架 MIT 开源永远免费,Chrome/Firefox/Safari 三内核通过 Chrome for Testing 自带打包免配驱动;付费的是 Playwright Cloud(云端浏览器/远程运行/并发扩展)与微软 Azure Playwright Testing 服务,本地跑 CI 自托管 Runner 完全 0 成本;
自动等待是默认行为但不是魔法——click/fill/type 会自动等待元素可见+可交互+稳定+未被遮挡(auto-waiting),但 30 秒超时未命中仍会抛错,复杂异步组件需显式
waitForSelector或waitForResponse兜底;2026 年最值得用的新能力是官方 Playwright MCP——
@playwright/mcp(微软官方维护,github.com/microsoft/playwright-mcp)让 Claude Desktop/Cursor/Copilot/Codex CLI 通过结构化无障碍树(accessibility tree)直接驱动浏览器,AI 不再靠截图猜元素,而是按角色+名字精准定位,比传统写 selector 省 80% 脚本维护时间。
🎁 永久免费的核心能力(MIT 开源,商用可闭源)
能力 | 免费版详情 |
|---|---|
三浏览器原生支持 | Chromium(Chrome/Edge)、Firefox、WebKit(Safari 内核),一套 API 行为完全一致,测试一次跨三端 |
Chrome for Testing | 自动下载锁定版本浏览器二进制,不用手动配 ChromeDriver/geckodriver,版本自动匹配 |
自动等待 Auto-waiting | click/fill/check/select/type 等操作自动等待元素可交互,告别 time.sleep/显式等待,flaky 率显著下降 |
网络拦截与 Mock |
|
Codegen 代码生成 |
|
Trace Viewer 追踪查看器 |
|
UI Mode 交互模式 |
|
并行与分片 |
|
多语言绑定 | Node.js / Python / Java / .NET(C#)四语言官方一等支持,Go/Rust 有社区绑定 |
跨平台 | Windows / macOS / Linux(含 Docker 官方镜像 |
多上下文隔离 | 一个 Browser 实例开多个 BrowserContext,独立 Cookie/Storage,多用户场景/会话隔离极快 |
强大 Locator | getByRole/getByText/getByLabel/getByPlaceholder/getByTestId 面向用户行为定位,比 CSS/XPath 更稳 |
组件/视觉回归 |
|
API Testing |
|
Accessibility 无障碍扫描 |
|
Playwright MCP(AI Agent) | 微软官方 |
📍 永久免费 + 开源 MIT:本地自托管运行没有任何次数/项目/时长上限;CI 里跑多少 Worker 都免费。
核心能力卡(6张)
🟢 三浏览器 + 免配驱动:Chromium / Firefox / WebKit 三内核一键 install,Chrome for Testing 自动匹配版本,再也不会出现 ChromeDriver 版本对不上的报错
🟡 自动等待 + 智能 Locator:所有操作默认等待元素可交互;getByRole/getByText/getByLabel 面向用户行为,改版不易碎
🔴 Codegen + Trace Viewer:
playwright codegen录操作出代码,失败用例--trace on打开 trace.playwright.dev 看每一步 DOM/网络/控制台🔵 UI Mode 时间旅行:
--ui开可视化面板,每条用例逐步回放、改代码自动重跑、DOM 快照+截图+日志一体化🟣 网络 Mock + API Testing:
route()拦截改响应、模拟断网/慢网/403;request上下文直接打 REST/GraphQL 接口,前后端一套框架🟠 Playwright MCP(AI Agent):官方 MCP Server 接 Claude Desktop / Cursor / ChatGPT / Codex CLI,自然语言驱动浏览器做测试、抓取、巡检
3 个必看避坑提示
不要用
page.waitForTimeout(3000)固定睡眠——官方明确反对,会让测试变慢且不稳定;用waitForSelector/waitForResponse/waitForLoadState('networkidle')事件驱动不要裸 CSS/XPath 选择器——
.login-form .btn-submit一改样式就碎;统一用page.getByRole('button', {name: '提交'})、page.getByTestId('submit-btn')面向行为和 roleCI 里必须装系统依赖——Linux 跑要装字体/共享库,用官方 Docker 镜像
mcr.microsoft.com/playwright:v1.63.0-noble最稳,或执行npx playwright install-deps
适合 vs 不适合
✅ 适合这些场景
Web 应用端到端测试(React/Vue/Angular/Next.js/Nuxt/Svelte 全栈框架)
CI/CD 流水线自动化回归(GitHub Actions/GitLab CI/Jenkins 全有官方 Action)
跨浏览器兼容性验证(Chrome/Edge/Firefox/Safari 一次跑)
网页抓取/数据采集(比 Requests+BS4 能跑 JS 渲染页)
页面巡检/监控(定时跑关键流程)
AI Agent 浏览器自动化(MCP 接入 Claude/Cursor)
❌ 不适合这些场景
大规模真机设备测试(iOS/Android 原生 App 建议 Appium)
性能压测(Playwright 是 UI 自动化不是 k6/JMeter)
强依赖特定浏览器非标准扩展/插件的场景
需要云端高并发多地域浏览器矩阵(走 Playwright Cloud / BrowserStack / LambdaTest 付费)
非浏览器桌面应用自动化(AutoIt/PyAutoGUI 更合适)
4 步上手(直接可复制)
Step 1:安装(以 Node.js 为例)
# 创建项目
npm init -y
npm i -D @playwright/test
# 安装三内核浏览器 + 系统依赖(大陆用镜像)
# Windows PowerShell: $env:PLAYWRIGHT_DOWNLOAD_HOST="https://registry.npmmirror.com/-/binary/playwright"
PLAYWRIGHT_DOWNLOAD_HOST=https://registry.npmmirror.com/-/binary/playwright npx playwright install
npx playwright install-deps
Python 版:pip install playwright && playwright install
Step 2:录屏生成你的第一个脚本
npx playwright codegen https://example.com
# 打开浏览器,点击操作,右侧面板直接生成可运行代码
Step 3:写第一个测试用例(example.spec.js)
import { test, expect } from '@playwright/test';
test('百度搜索壹贰云测评', async ({ page }) => {
await page.goto('https://www.baidu.com');
await page.getByLabel('搜索').fill('壹贰云测评');
await page.getByRole('button', { name: '百度一下' }).click();
// 自动等待结果出现
await expect(page.locator('#content_left')).toContainText('壹贰云测评');
// 失败自动截图+Trace
});
Step 4:跑测试 + 看 Trace + UI 模式
# 跑测试,失败自动存 trace
npx playwright test --trace on
# 打开 trace 查看器(时间旅行)
npx playwright show-report
# UI 模式:可视化面板逐步调试
npx playwright test --ui
# 三浏览器并行
npx playwright test --browser=all
🤖 接 AI Agent(Playwright MCP,Cursor/Claude Desktop)
在 Cursor/Claude Desktop 的 MCP 配置文件里加:
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
重启后对 AI 说"打开百度搜索壹贰云测评,截图前3条结果",AI 会自己调用浏览器操作。
8 款免费/开源浏览器自动化工具横向对比
工具 | 协议 | 浏览器支持 | 自动等待 | Codegen | MCP/AI | 免费额度 | 适合场景 |
|---|---|---|---|---|---|---|---|
Playwright | CDP 原生 | Chromium/Firefox/WebKit | ✅原生 | ✅ | ✅@playwright/mcp | MIT 永久免费 | E2E 测试首选 |
Selenium | WebDriver | 全浏览器 | ❌手动 | ❌ | 第三方 | Apache 2.0 | 老项目/多浏览器矩阵 |
Cypress | Chrome DevTools | Chromium 为主 | ✅ | ✅ | ✅官方 | MIT 开源 | 前端单测/组件测 |
Puppeteer | CDP | Chromium/Firefox | ❌半手动 | ❌ | 第三方 | Apache 2.0 | 爬虫/截图 |
Playwright Cloud | 托管 | 三浏览器 | ✅ | ✅ | ✅ | 500测试/月免费 | 云端并发扩展 |
BrowserStack | SaaS | 真机/多浏览器 | - | - | - | 免费试用 | 真机兼容性 |
LambdaTest | SaaS | 3000+浏览器 | - | - | - | 免费试用 | 云测平台 |
Robot Framework | Keyword | 多浏览器 | ❌ | ❌ | - | Apache 2.0 | 关键字驱动传统测试 |
付费档位参考
本地/CI 自托管:MIT 永久免费,0 成本;
Playwright Cloud:新用户免费额度(约 500 测试/月),付费按并发/测试分钟计费;
Azure Playwright Testing:微软官方云测服务,新用户 50,000 虚拟用户分钟/月免费试用;
第三方云浏览器:BrowserStack/LambdaTest/Sauce Labs 均提供 Playwright 对接,按并发/分钟计费。
你在用 Playwright 吗?觉得它比 Selenium/Cypress 香在哪?踩过哪些坑(尤其是 CI 环境依赖/选择器脆弱/网络 Mock 这些老问题)?
文中规则与配额以官方 GitHub 仓库与文档为准(核实时点:2026 年 11 月)。
壹贰线报 · GitHub 官方仓库核实