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

Python Playwright库详解：从入门到实战

news 2025/7/27 5:45:03

一、项目简介

Playwright是由微软开发的现代化浏览器自动化库，支持通过统一API控制Chromium、Firefox、WebKit三大浏览器引擎。其核心特性包括：

跨浏览器兼容性：一套代码适配所有主流浏览器
自动等待机制：智能等待元素就绪，告别随机失败
强大网络控制：支持请求拦截、模拟和修改
移动设备模拟：内置50+种设备参数，轻松适配移动端
同步/异步双模式：兼顾易用性与执行效率

二、安装部署

2.1 环境要求

Python 3.7+
Windows/MacOS/Linux系统
推荐使用Pytest作为测试框架

2.2 快速安装

# 安装核心库
pip install playwright# 下载浏览器二进制文件（自动识别系统环境）
python -m playwright install# 安装Pytest插件（可选）
pip install pytest-playwright

2.3 验证安装

from playwright.sync_api import sync_playwrightwith sync_playwright() as p:browser = p.chromium.launch()page = browser.new_page()page.goto("https://playwright.dev")print(page.title())  # 应输出 "Playwright"browser.close()

三、核心功能详解

3.1 基础操作流程

from playwright.sync_api import sync_playwrightwith sync_playwright() as p:# 启动浏览器（有头模式便于调试）browser = p.chromium.launch(headless=False)# 创建新上下文（隔离环境）context = browser.new_context()# 打开页面page = context.new_page()# 基础操作示例page.goto("https://baidu.com")page.fill("input[name=wd]", "Playwright教程")page.click("text=百度一下")# 截图保存page.screenshot(path="search_result.png")# 关闭资源context.close()browser.close()

3.2 元素定位策略

# 文本选择器（推荐）
page.click("text=立即购买")# CSS选择器
page.fill(".search-box", "关键词")# XPath选择器
page.click('//button[@id="submit"]')# 响应式选择器（自动适配移动端）
page.locator("button:visible").click()

3.3 高级功能实现

3.3.1 网络请求拦截

def test_api_mock():with sync_playwright() as p:browser = p.chromium.launch()page = browser.new_page()# 启用请求拦截page.route("**/api/data", lambda route: route.fulfill(status=200,json={"message": "Custom Response"}))page.goto("https://example.com")assert page.locator(".data-display").text_content() == "Custom Response"browser.close()

3.3.2 移动设备模拟

def test_mobile_view():with sync_playwright() as p:iphone = p.devices['iPhone 12']browser = p.chromium.launch()# 创建移动设备上下文context = browser.new_context(**iphone,locale='zh-CN',timezone_id='Asia/Shanghai')page = context.new_page()page.goto("https://m.taobao.com")page.screenshot(path="mobile_view.png")context.close()browser.close()

3.3.3 异步执行模式

import asyncio
from playwright.async_api import async_playwrightasync 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 browser.close()asyncio.run(main())

四、最佳实践

4.1 测试组织策略

# pytest_playwright示例
import pytest@pytest.fixture(scope="function")
def browser():pw = sync_playwright().start()browser = pw.chromium.launch()yield browserbrowser.close()def test_search(browser):page = browser.new_page()page.goto("https://bing.com")page.fill("input[name=q]", "Playwright最佳实践")page.click("text=搜索")assert "Playwright最佳实践" in page.content()

4.2 调试技巧

# 日志记录配置
import logging
logging.basicConfig(level=logging.DEBUG,format='%(asctime)s - %(levelname)s - %(message)s'
)# 截图辅助调试
try:page.click("#submit")
except Exception as e:page.screenshot(path="error_debug.png")raise e

4.3 性能优化

# 并行执行配置（pytest.ini）
[pytest]
addopts = -n auto# 资源复用
def test_parallel():with sync_playwright() as p:contexts = []for _ in range(10):contexts.append(p.chromium.launch().new_context())# 并行执行测试...

五、常见问题解决

Q1: 安装时提示"Permission denied"
A: 使用以下命令修复权限：

sudo chown -R $USER ~/.cache/playwright

Q2: 元素定位失败
A: 尝试以下方法：

# 增加等待时间
page.wait_for_selector(".target-element")# 使用更鲁棒的选择器
page.locator("text=立即购买 >> nth=0").click()

Q3: 如何处理登录认证
A: 使用存储状态功能：

context = browser.new_context(storage_state="auth_state.json"
)
# 或手动输入凭证
page.fill("#username", "admin")
page.fill("#password", "123456")
page.click("#login")