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

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_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 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 browser
    browser.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")

六、总结

Playwright 通过其现代化的设计和丰富的功能集，已成为 Web 自动化领域的首选工具。其核心优势体现在：

• 跨浏览器一致性：统一 API 适配所有主流浏览器
• 开发效率：自动等待和智能定位减少 80% 的调试时间
• 测试可靠性：内置网络模拟和移动适配能力
• 生态完善：与 Pytest 等框架无缝集成

建议开发者从基础操作入手，逐步掌握网络拦截、设备模拟等高级功能，结合项目需求构建完整的自动化测试体系。

七、附录

• 官方文档：https://playwright.dev/python
• 设备参数表：https://playwright.dev/python/api/class-devices
• GitHub 仓库：https://github.com/microsoft/playwright-python