Python Playwright库从入门到实战教程

目录

• 一、项目简介
• 二、安装部署
• 2.1 环境要求
• 2.2 快速安装
• 2.3 验证安装
• 三、核心功能详解
• 3.1 基础操作流程
• 3.2 元素定位策略
• 3.3 高级功能实现
• 3.3.1 网络请求拦截
• 3.3.2 移动设备模拟
• 3.3.3 异步执行模式
• 四、最佳实践
• 4.1 测试组织策略
• 4.2 调试技巧
• 4.3 性能优化
• 五、常见问题解决
• 六、总结
• 七、附录

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

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

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

# 安装核心库
pip install playwright

# 下载浏览器二进制文件（自动识别系统环境）
python -m playwright install

# 安装Pytest插件（可选）
pip install pytest-playwright

from playwright.sync_api import sync_playwright

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

from playwright.sync_api import sync_playwright

with 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()

# 文本选择器（推荐）
page.click("text=立即购买")

# CSS选择器
page.fill(".search-box", "关键词")

# XPath选择器
page.click('//button[@id="submit"]')

# 响应式选择器（自动适配移动端）
page.locator("button:visible").click()

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()

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()

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())

# 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()

# 日志记录配置
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

# 并行执行配置（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
• 交流社区：https://gitter.im/microsoft/playwright

到此这篇关于Python Playwright库从入门到实战的文章就介绍到这了,更多相关Python Playwright库详解内容请搜索风君子博客以前的文章或继续浏览下面的相关文章希望大家以后多多支持风君子博客！

您可能感兴趣的文章:

• Python开源自动化工具Playwright安装及介绍使用
• Python中Playwright的常用操作方法分享
• Python Playwright的使用详解
• Python自动化神器Playwright的用法详解
• Python写UI自动化之playwright(点击操作)详解
• Python Playwright安装和基本使用问题记录
• python+playwright微软自动化工具的使用
• Python Playwright进行常见的页面交互操作
• Python中Playwright模块进行自动化测试的实现