Playwright:完全开源 MIT 的端到端自动化测试框架(真·永久免费)

Playwright — 完全开源(MIT),本地或在 CI 中免费运行。为 Chromium、Firefox、WebKit 提供可靠的端到端测试,内置自动等待、网络模拟、代码生成、追踪查看器、UI 模式;跨浏览器、跨平台、Node.js / Python / Java / .NET 绑定。

官方入口:https://playwright.dev | GitHub 66k+ Stars | 微软维护


  1. 本地/CI 自托管运行器永远免费,"云"才收费——Playwright 核心框架 MIT 开源永远免费,Chrome/Firefox/Safari 三内核通过 Chrome for Testing 自带打包免配驱动;付费的是 Playwright Cloud(云端浏览器/远程运行/并发扩展)与微软 Azure Playwright Testing 服务,本地跑 CI 自托管 Runner 完全 0 成本;

  2. 自动等待是默认行为但不是魔法——click/fill/type 会自动等待元素可见+可交互+稳定+未被遮挡(auto-waiting),但 30 秒超时未命中仍会抛错,复杂异步组件需显式 waitForSelector 或 waitForResponse 兜底;

  3. 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

page.route() 拦截请求、Mock API 响应、修改 Header、阻断第三方脚本、模拟慢网/断网

Codegen 代码生成

npx playwright codegen url 启动录屏,点击操作直接生成可运行脚本,支持所有语言绑定

Trace Viewer 追踪查看器

--trace on 录制完整执行轨迹(DOM 快照、网络请求、控制台日志、截图),失败用例事后可视化回放

UI Mode 交互模式

npx playwright test --ui 开可视化面板,时间旅行调试、Watch 模式、按文件/标签筛选、失败自动高亮

并行与分片

workers: N 多 Worker 并行执行,shard 跨机器分桶,CI 上几十条测试并行跑完只要几分钟

多语言绑定

Node.js / Python / Java / .NET(C#)四语言官方一等支持,Go/Rust 有社区绑定

跨平台

Windows / macOS / Linux(含 Docker 官方镜像 mcr.microsoft.com/playwright)、WSL2 原生支持

多上下文隔离

一个 Browser 实例开多个 BrowserContext,独立 Cookie/Storage,多用户场景/会话隔离极快

强大 Locator

getByRole/getByText/getByLabel/getByPlaceholder/getByTestId 面向用户行为定位,比 CSS/XPath 更稳

组件/视觉回归

toHaveScreenshot() 像素级视觉对比,expect(locator).toMatchAriaSnapshot() 无障碍树快照

API Testing

request.newContext() 直接发 REST/GraphQL 请求,前后端联调/接口测试在同一个框架里完成

Accessibility 无障碍扫描

@axe-core/playwright 官方集成,自动检测 WCAG 合规问题

Playwright MCP(AI Agent)

微软官方 @playwright/mcp@latest,Claude/Cursor/ChatGPT/Copilot 直接驱动浏览器做测试/抓取/操作

📍 永久免费 + 开源 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 个必看避坑提示

  1. 不要用 page.waitForTimeout(3000) 固定睡眠——官方明确反对,会让测试变慢且不稳定;用 waitForSelector/waitForResponse/waitForLoadState('networkidle') 事件驱动

  2. 不要裸 CSS/XPath 选择器——.login-form .btn-submit 一改样式就碎;统一用 page.getByRole('button', {name: '提交'})、page.getByTestId('submit-btn') 面向行为和 role

  3. CI 里必须装系统依赖——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 官方仓库核实


版权声明

本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。