当前位置：首页 > news >正文

Playwright 教程

news 2026/7/29 14:26:50

Playwright 教程（2025 年最新版）

Playwright 是 Microsoft 开源的现代化 Web 自动化测试和爬虫框架，支持 Chromium、Firefox 和 WebKit（Safari）三大浏览器内核，提供跨浏览器、跨语言（JavaScript/TypeScript、Python、Java、.NET）的统一 API。它以自动等待、可靠事件、网络拦截和代码生成等特性著称，比 Selenium 更稳定、更快，尤其适合端到端（E2E）测试和动态网页自动化。

1.为什么选择 Playwright？（2025 年优势）

跨浏览器一致性：一套代码跑所有主流浏览器。
自动等待：元素可操作前自动等待，无需手动 sleep。
内置测试运行器：Playwright Test 支持并行、报告、追踪。
代码生成：playwright codegen可录制操作自动生成脚本。
移动端模拟：内置设备模拟，支持响应式测试。
社区活跃：2025 年版本已达 1.57+，新增 AI 代理、MCP 等特性。

2.安装与环境搭建

推荐使用 Node.js（JavaScript/TypeScript）或 Python 版本，这里以最流行的Python和Node.js示例。

Python 版（推荐新手）：

# 安装 Playwrightpipinstallplaywright# 安装浏览器驱动（Chromium、Firefox、WebKit）playwrightinstall

Node.js 版：

# 初始化项目npminit playwright@latest# 或手动安装npmi -D @playwright/test npx playwrightinstall

3.第一个脚本示例

Python 同步版（简单易懂）：

fromplaywright.sync_apiimportsync_playwrightwithsync_playwright()asp:browser=p.chromium.launch(headless=False)# headless=False 可看到浏览器page=browser.new_page()page.goto("https://www.baidu.com")page.fill("#kw","Playwright 教程")page.click("#su")page.wait_for_selector("text=Playwright 中文文档")# 自动等待print(page.title())page.screenshot(path="baidu.png")# 截图browser.close()

Node.js/TypeScript 版：

import{chromium}from'playwright';(async()=>{constbrowser=awaitchromium.launch({headless:false});constpage=awaitbrowser.new_page();awaitpage.goto('https://www.baidu.com');awaitpage.fill('#kw','Playwright');awaitpage.click('#su');awaitpage.waitForSelector('text=Playwright');awaitpage.screenshot({path:'baidu.png'});awaitbrowser.close();})();

运行：python script.py或npx playwright test。

4.核心功能速览

定位器（Locators）：page.get_by_role()、page.get_by_text()、page.locator()等，更智能。
断言：expect(page.locator()).to_have_text("xxx")。
网络拦截：模拟 API 响应、mock 数据。

代码录制：

npx playwright codegen https://example.com# 自动生成脚本

测试运行：

npx playwrighttest# 运行所有测试npx playwrighttest--ui# UI 模式可视化运行npx playwright show-report# 查看 HTML 报告

5.推荐学习资源（中文优先，2025 年最新）

官方文档（最权威，必看）：
- 英文：https://playwright.dev/
- Python 中文：https://playwright.net.cn/python/docs/intro
- Node.js 中文：https://playwright.nodejs.cn/
菜鸟教程（中文完整系列）：https://www.runoob.com/playwright/playwright-tutorial.html （从安装到高级操作）
CSDN 详细教程：https://blog.csdn.net/m0_51156601/article/details/126886040 （最详细使用教程）
知乎新手篇：https://zhuanlan.zhihu.com/p/669159171 （Java/Python/Node 全覆盖）
博客园 Python 系列：https://www.cnblogs.com/longronglang/p/18255415 （环境 + 录制 + 实战）
Playwright 中文社区：https://playwright.itest.info/ （进阶翻译 + 资源站）
视频教程：YouTube “Playwright Beginner Tutorials” 播放列表，或 B 站搜索 “Playwright 教程”。