Playwright快速入门：环境配置与第一个自动化脚本

原创于 2025-08-12 17:21:50 发布 · 754 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#自动化 #运维 #人工智能 #开发语言 #开源 #单元测试 #playwright

Web自动化测试神器Playwright‌ 专栏收录该内容

36 篇文章

订阅专栏

一、Playwright 简介与核心优势

Playwright 是微软开源的现代化 Web 自动化工具，支持 Chromium（Chrome/Edge）、Firefox、WebKit（Safari） 三大浏览器引擎，提供跨平台（Windows/macOS/Linux）和跨语言（Python/JS/Java/C#）的统一 API。其核心优势包括：

智能等待机制：自动检测元素可交互性（如点击、输入），减少因网络延迟导致的测试失败
录制与调试工具：内置 codegen 实时生成操作脚本，大幅降低学习成本。
真移动端模拟：内置设备描述符（如 iPhone 13），无需额外配置即可模拟手机环境。

二、环境搭建（10分钟搞定！）

1. 安装 Python 环境（需 3.8+）

# 检查 Python 版本
python --version
# 安装 Playwright 库
pip install playwright
# 安装浏览器驱动（自动下载 Chromium/Firefox/WebKit）
playwright install

避坑提示：国内用户可通过镜像加速下载：

set PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright
playwright install

2. 验证安装

运行以下脚本，成功输出浏览器标题即表示环境就绪：

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(headless=False)  # 显示浏览器界面
    page = browser.new_page()
    page.goto("https://playwright.dev")
    print("页面标题:", page.title())  # 应输出：Fast and reliable end-to-end testing
    browser.close()

✅ 成功标志：浏览器自动打开并显示 Playwright 官网，控制台打印正确标题。

三、首个自动化脚本：网页导航与截图

脚本目标

访问 https://example.com，保存全页面截图并输出标题。

from playwright.sync_api import sync_playwright

def run():
    with sync_playwright() as p:
        # 启动浏览器并访问网页
        browser = p.chromium.launch(headless=False)
        page = browser.new_page()
        page.goto("https://example.com")
        
        # 保存全屏截图（自动等待页面加载完成）
        page.screenshot(path="example.png", full_page=True)
        print("页面标题:", page.title())  # 输出：Example Domain
        
        browser.close()

if __name__ == "__main__":
    run()

效果说明：

自动打开浏览器访问 example.com。
生成全页截图 example.png。
控制台输出标题 "Example Domain" 。

四、避坑指南与调试技巧

浏览器启动失败：
- 确保已执行 playwright install 安装浏览器内核。
- 若报权限错误，尝试以管理员身份运行终端。
截图不完整：
- 添加 full_page=True 参数捕获完整页面。
- 使用 page.wait_for_load_state("networkidle") 确保资源加载完成。
调试神器：
- 脚本录制：playwright codegen https://example.com 操作浏览器自动生成代码，适合快速原型设计。
- 执行追踪：通过 Trace Viewer 回放操作过程（含网络请求与DOM快照）：
```
context = browser.new_context()
context.tracing.start(screenshots=True, snapshots=True)
# ...执行操作...
context.tracing.stop(path="trace.zip")
# 查看日志：npx playwright show-trace trace.zip
```

五、同步 vs 异步模式选择

模式	适用场景	代码示例
同步	简单脚本/快速调试	`from playwright.sync_api import ...`
异步	高并发任务/爬虫	`await page.goto(...)`
异步示例（爬虫效率提升3倍+）：

import asyncio
from playwright.async_api import async_playwright

async def main():
    async with async_playwright() as p:
        browser = await p.chromium.launch()
        page = await browser.new_page()
        await page.goto("https://example.com")
        await page.screenshot(path="async_example.png")
        await browser.close()

asyncio.run(main())

学习交流群

爱测智能化服务平台

测开人必看！0代码+AI驱动，测试效率飙升300% ——霍格沃兹测试开发学社‌重磅上新‌「爱测智能化服务平台」限时开放体验！

一码难求的Manus：智能体技术如何重构生产力？测试领域又有哪些新机遇？

开源工具

AppCrawler 开源版
https://github.com/seveniruby/AppCrawler

Hogwarts-Browser-Use 开源版
指导安装贴：hogwarts-browser-use - 开源项目 - 爱测-测试人社区

专业版（7天免费试用）

自动遍历测试框架 AppCrawler 专业版
通用数据驱动测试框架 hogwarts-ddt 专业版
测试智能体框架 hogwarts-agent 专业版

学社提供的资源

教育官网：霍格沃兹测试开发学社
科技官网：测吧（北京）科技有限公司
火焰杯就业选拔赛：火焰杯就业选拔赛 - 霍格沃兹测试开发学社
火焰杯职业竞赛：火焰杯职业竞赛 - 霍格沃兹测试开发学社
学习路线图：霍格沃兹测试开发学社
公益社区论坛：爱测-测试人社区 - 软件测试开发爱好者的交流社区，交流范围涵盖软件测试、自动化测试、UI测试、接口测试、性能测试、安全测试、测试开发、测试平台、开源测试、测试教程、测试面试题、appium、selenium、jmeter、jenkins
公众号：霍格沃兹测试学院
视频号：霍格沃兹软件测试
ChatGPT体验地址：霍格沃兹测试开发学社

本套视频教程所有配套资料领取方式如下: