Playwright

Playwright 是由微软推出的开源端到端测试框架，专为现代 Web 应用设计，支持 Chromium、Firefox、WebKit 三引擎并行执行，具备自动等待、网络拦截、多页面/iframe 上下文管理、移动设备模拟等能力。适用于 CI/CD 集成、跨浏览器回归测试、可视化回归、爬虫原型验证及自动化交互场景，显著提升测试稳定性与执行速度。

# Playwright — 现代化端到端测试框架 ## 框架简介与定位 Playwright 是由 Microsoft 开源的跨浏览器端到端（E2E）测试与自动化框架，旨在解决传统工具（如 Selenium）在稳定性、速度、多浏览器一致性及现代 Web 特性（如 Shadow DOM、单页应用路由、WebSockets）支持上的局限。它通过直接与浏览器底层协议（如 Chrome DevTools Protocol 和 Firefox Marionette）集成，实现零配置、高可靠性的自动化控制，适用于 Web 应用质量保障、DevOps 测试流水线及复杂 UI 交互验证。 ## 核心特性 - ✅ **原生多浏览器支持**：开箱即用支持 Chromium、Firefox、WebKit（含 Safari 兼容模式），无需额外驱动安装； - ✅ **自动等待与智能选择器**：内置自动等待机制（如元素可交互、网络空闲、导航完成），支持基于文本、角色（`role=`）、CSS 属性、XPath 的弹性定位策略； - ✅ **网络层深度控制**：支持请求/响应拦截、Mock 路由（`route()`）、断网模拟、自定义 headers 及请求重写，便于测试异常流与 API 依赖隔离； - ✅ **并发与上下文隔离**：每个测试用例默认运行在独立 `BrowserContext` 中，支持多页面、多标签页、iframe 内嵌上下文切换，避免状态污染； - ✅ **真实设备与视口模拟**：内置移动端设备指纹（如 iPhone 13、Pixel 5）、地理定位、权限控制（通知、摄像头）、色盲模式等，支持 PWA 和离线场景测试。 ## 适用场景 - 跨浏览器兼容性回归测试（尤其 WebKit/Safari 行为验证）； - 单页应用（SPA）与微前端架构的端到端流程验证（登录 → 导航 → 表单提交 → 弹窗交互）； - CI/CD 流水线中的稳定、快速 E2E 测试（支持 GitHub Actions、GitLab CI 原生集成）； - 可视化回归测试（配合 `@playwright/test` + `expect().toHaveScreenshot()`）； - 自动化数据抓取（带 JS 渲染、登录态维持、反爬绕过基础能力）； - 开发阶段的交互原型验证与调试辅助（`codegen` 录制、`trace-viewer` 可视化追踪）。 ## 快速入门步骤 1. **安装**（Node.js ≥ 16）： ```bash npm init playwright@latest # 或手动安装 npm install --save-dev @playwright/test npx playwright install chromium firefox webkit ``` 2. **最小示例思路**（以 TypeScript 为例）： - 创建 `example.spec.ts`； - 使用 `test()` 定义用例，`page` 对象访问页面； - 调用 `page.goto()` 加载 URL，`page.getByRole('button', { name: 'Login' }).click()` 触发交互； - 断言使用 `await expect(page).toHaveTitle(/Dashboard/)`； - 运行：`npx playwright test`。 ## 生态与社区 Playwright 官方提供完整 TypeScript/JavaScript/Python/Java/.NET 多语言 SDK，核心库 `@playwright/test` 内置测试运行器、断言、报告器（HTML、JUnit、JSON）及并行执行能力。活跃社区维护于 GitHub（[playwright/playwright](https://github.com/microsoft/playwright)），文档详尽（[playwright.dev](https://playwright.dev)），每月发布稳定版本，企业级用户包括 Microsoft、Adobe、Shopify 等。插件生态丰富，支持与 Jest、Cypress（迁移工具）、Allure 报告集成。