Python 自动化测试工具 Playwright 核心功能与实战详解

镜像源加速

在国内网络环境下，如果下载速度缓慢，建议更换 pip 镜像源：

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

虚拟环境推荐

为了保持项目依赖隔离，建议在虚拟环境中安装：

python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows
pip install playwright

5、快速开始：同步与异步

Playwright 同时支持同步和异步两种编程模式，开发者可根据项目需求选择。

同步模式示例

同步模式语法简单，适合初学者或简单的脚本任务：

from playwright.sync_api import sync_playwright
from time import sleep

with sync_playwright() as p:
    # 启动浏览器，headless=False 表示显示浏览器窗口
    browser = p.chromium.launch(headless=False)
    page = browser.new_page()
    
    # 导航到目标网址
    page.goto('https://www.example.com')
    
    # 获取页面标题
    print(page.title())
    
    # 等待 10 秒以便观察效果
    sleep(10)
    
    browser.close()

异步模式示例

异步模式利用 asyncio 实现高并发，适合大规模测试场景：

import asyncio
from time import sleep
from playwright.async_api import async_playwright

async def main():
    async with async_playwright() as p:
        browser = await p.firefox.launch(headless=False)
        page = await browser.new_page()
        
        await page.goto('https://www.example.com')
        title = await page.title()
        print(title)
        
        await browser.close()

asyncio.run(main())

6、高级定位器策略

稳定的元素定位是自动化测试成功的关键。Playwright 提供了多种强大的定位器。

CSS 选择器

page.click('#submit-button')
page.fill('.input-field', 'Hello World')

XPath 定位

虽然不推荐作为首选，但 Playwright 仍支持 XPath：

page.click('//button[@type="submit"]')

文本内容定位

直接根据页面上的可见文本来定位元素：

page.click('text=Submit')
page.click('text=Login')

角色定位（Accessibility Role）

利用 ARIA 角色进行定位，更符合无障碍规范：

page.click('role=button[name="Submit"]')

Data-testid 属性

最佳实践是在 HTML 中为关键元素添加 data-testid 属性：

<button data-testid="login-btn">Login</button>

page.click('[data-testid="login-btn"]')

7、自动等待机制

Playwright 最大的优势之一是自动等待。在执行大多数操作前，它会检查元素是否满足以下条件：

• 存在于 DOM 中
• 可见（非 display: none）
• 可交互（enabled）
• 不在动画过渡中

这意味着你不需要在代码中硬编码 sleep() 或复杂的显式等待逻辑。如果元素未就绪，Playwright 会自动重试直到超时。

# 即使按钮加载慢，click 也会自动等待其就绪
page.click('#submit-btn') 

8、断言与期望

Playwright 内置了丰富的断言方法，用于验证页面状态。

# 验证元素存在
assert page.is_visible('#header')

# 验证文本内容
expect(page.locator('.title')).to_contain_text('Welcome')

# 验证 URL
expect(page).to_have_url('https://www.example.com/page')

# 验证颜色值
expect(page.locator('.box')).to_have_css('background-color', 'rgb(255, 0, 0)')

9、处理复杂 UI 场景

弹窗与模态框

# 监听新窗口
with page.expect_popup() as popup_info:
    page.click('#open-modal')
popup = popup_info.value
popup.wait_for_load_state()

文件上传

page.set_input_files('input[type=file]', 'path/to/file.pdf')

处理 Iframe

frame = page.frame_locator('iframe[src="/embedded"]')
frame.locator('#inner-input').fill('Content in iframe')

10、代码生成器

Playwright 自带命令行工具，可记录用户操作并生成代码。

# 启动代码生成器
playwright codegen https://www.example.com

在弹出的浏览器中进行点击、输入等操作，右侧会实时显示对应的 Python 代码。这对于不熟悉 API 的开发人员非常友好，可作为学习起点。

11、追踪查看器（Trace Viewer）

当测试失败时，Trace Viewer 能提供详细的执行快照。

启用追踪

trace_path = 'trace.zip'
page.start_tracing(path=trace_path)
# ... 执行测试操作 ...
page.stop_tracing()

查看追踪

playwright show-trace trace.zip

这将打开一个交互式界面，展示每一步操作的 DOM 快照、网络请求、控制台日志和鼠标轨迹，极大简化了调试过程。

12、CI/CD 集成

Playwright 易于集成到 GitHub Actions 等 CI 流程中。

- name: Install dependencies
  run: npm ci && npx playwright install --with-deps

- name: Run tests
  run: npx playwright test

13、最佳实践总结

1. 使用 Page Object Model (POM)：将页面元素和操作封装成类，提高代码复用性和可维护性。
2. 避免硬编码等待：信任 Playwright 的自动等待机制。
3. 使用唯一标识符：优先使用 data-testid 而非脆弱的 CSS/XPath。
4. 并行执行：利用 Playwright 的并行测试能力缩短执行时间。
5. 定期更新：关注官方发布说明，及时适配新特性。

14、结语

Playwright 凭借其现代化的架构、丰富的功能和优秀的开发者体验，已成为 Web 自动化测试的首选工具之一。无论是个人开发者还是企业团队，都能从中受益。掌握 Playwright 不仅能提升测试效率，还能推动研发流程的质量保障体系建设。