闲社

标题: 【教程】用Python+Playwright打造自动化测试框架：从零搭建到CI/CD集成 [打印本页]
作者: gue3004    时间: 1 小时前
标题: 【教程】用Python+Playwright打造自动化测试框架：从零搭建到CI/CD集成
【教程】用Python+Playwright打造自动化测试框架：从零搭建到CI/CD集成

一、前置条件

在开始之前，请确保你的环境满足以下条件：



二、为什么选Playwright？

最近uniTerm v1.0正式开源发布，深度集成AI Agent的终端智能能力引发热议。而在Web自动化测试领域，Playwright正以碾压之势取代Selenium成为新标杆。

核心优势：


三、步骤1：环境搭建
  2. # 创建项目目录
  3. mkdir playwright-demo && cd playwright-demo
  5. # 创建虚拟环境
  6. python -m venv venv
  7. source venv/bin/activate  # Linux/Mac
  8. # venv\Scripts\activate  # Windows
  10. # 安装Playwright
  11. pip install pytest-playwright
  13. # 安装浏览器二进制文件
  14. playwright install
复制代码

验证安装：
  2. playwright --version
  3. # 输出类似：Version 1.49.0
复制代码

四、步骤2：编写第一个测试

创建 test_example.py：
  2. import re
  3. from playwright.sync_api import Page, expect
  5. def test_has_title(page: Page):
  6.     page.goto("https://playwright.dev/")
  7.    
  8.     # 断言页面标题包含Playwright
  9.     expect(page).to_have_title(re.compile("Playwright"))
  11. def test_get_started_link(page: Page):
  12.     page.goto("https://playwright.dev/")
  13.    
  14.     # 点击Get started链接
  15.     page.get_by_role("link", name="Get started").click()
  16.    
  17.     # 断言页面URL包含intro
  18.     expect(page).to_have_url(re.compile(".*intro"))
复制代码

运行测试：
  2. pytest test_example.py --headed  # 有界面模式
  3. pytest test_example.py          # 无头模式（推荐CI使用）
复制代码

五、步骤3：Page Object模式实战

对于复杂项目，推荐Page Object模式组织代码。以登录功能为例：

创建 pages/login_page.py：
  2. from playwright.sync_api import Page
  4. class LoginPage:
  5.     def __init__(self, page: Page):
  6.         self.page = page
  7.         self.username_input = page.locator("#username")
  8.         self.password_input = page.locator("#password")
  9.         self.login_button = page.locator("button[type='submit']")
  10.         self.error_message = page.locator(".alert-danger")
  11.    
  12.     def navigate(self, url: str):
  13.         self.page.goto(url)
  14.         return self
  15.    
  16.     def login(self, username: str, password: str):
  17.         self.username_input.fill(username)
  18.         self.password_input.fill(password)
  19.         self.login_button.click()
  20.         return self
  21.    
  22.     def get_error_text(self) -> str:
  23.         return self.error_message.inner_text()
复制代码

创建 test_login.py：
  2. import pytest
  3. from playwright.sync_api import Page
  4. from pages.login_page import LoginPage
  6. class TestLogin:
  7.     def test_successful_login(self, page: Page):
  8.         login_page = LoginPage(page)
  9.         login_page.navigate("https://example.com/login")
  10.         login_page.login("admin", "correct_password")
  11.         
  12.         # 断言登录成功后的跳转
  13.         assert page.url == "https://example.com/dashboard"
  14.    
  15.     def test_failed_login(self, page: Page):
  16.         login_page = LoginPage(page)
  17.         login_page.navigate("https://example.com/login")
  18.         login_page.login("admin", "wrong_password")
  19.         
  20.         # 断言错误提示
  21.         error_text = login_page.get_error_text()
  22.         assert "用户名或密码错误" in error_text
复制代码

六、步骤4：数据驱动与参数化

使用pytest参数化实现数据驱动：
  2. import pytest
  3. from playwright.sync_api import Page
  4. from pages.login_page import LoginPage
  6. @pytest.mark.parametrize("username,password,expected", [
  7.     ("admin", "correct_pass", "success"),
  8.     ("admin", "wrong_pass", "error"),
  9.     ("", "", "error"),
  10.     ("invalid_user", "any_pass", "error"),
  11. ])
  12. def test_login_scenarios(page: Page, username, password, expected):
  13.     login_page = LoginPage(page)
  14.     login_page.navigate("https://example.com/login")
  15.     login_page.login(username, password)
  16.    
  17.     if expected == "success":
  18.         assert "dashboard" in page.url
  19.     else:
  20.         error_text = login_page.get_error_text()
  21.         assert len(error_text) > 0
复制代码

七、步骤5：CI/CD集成（GitHub Actions）

创建 .github/workflows/playwright.yml：
  2. name: Playwright Tests
  4. on:
  5.   push:
  6.     branches: [main, develop]
  7.   pull_request:
  8.     branches: [main]
  10. jobs:
  11.   test:
  12.     runs-on: ubuntu-latest
  13.     steps:
  14.       - uses: actions/checkout@v4
  15.       
  16.       - name: Set up Python
  17.         uses: actions/setup-python@v5
  18.         with:
  19.           python-version: '3.11'
  20.       
  21.       - name: Install dependencies
  22.         run: |
  23.           pip install pytest-playwright
  24.           playwright install --with-deps
  25.       
  26.       - name: Run tests
  27.         run: pytest --tracing=retain-on-failure
  28.       
  29.       - name: Upload trace
  30.         if: failure()
  31.         uses: actions/upload-artifact@v4
  32.         with:
  33.           name: playwright-traces
  34.           path: test-results/
复制代码

八、步骤6：高级技巧

1. 自动录制视频与截图
  2. # pytest.ini
  3. [pytest]
  4. addopts = --video=retain-on-failure --screenshot=only-on-failure
复制代码

2. 移动端模拟
  2. from playwright.sync_api import sync_playwright
  4. with sync_playwright() as p:
  5.     iphone = p.devices['iPhone 14']
  6.     browser = p.chromium.launch()
  7.     context = browser.new_context(**iphone)
  8.     page = context.new_page()
  9.     page.goto('https://example.com')
复制代码

3. API拦截与Mock
  2. # 拦截API请求并返回Mock数据
  3. page.route("**/api/users", lambda route: route.fulfill(
  4.     status=200,
  5.     content_type="application/json",
  6.     body='{"users": [{"id": 1, "name": "Mock User"}]}'
  7. ))
复制代码

九、常见问题

Q1: 测试在CI中失败，本地正常？
A: 通常是等待时间问题。Playwright的自动等待已很智能，但复杂异步加载场景建议增加显式等待：
  1. page.wait_for_load_state('networkidle')
复制代码

Q2: 如何处理动态变化的元素定位？
A: 优先使用语义化定位（get_by_role/get_by_text），避免依赖CSS选择器：
  1. page.get_by_role("button", name="提交").click()
复制代码

Q3: 测试执行太慢？
A: 启用并行执行：
  1. pytest -n auto  # 需要安装pytest-xdist
复制代码

Q4: 如何调试失败的测试？
A: 使用Trace Viewer：
  2. pytest --tracing=on
  3. playwright show-trace trace.zip
复制代码

十、总结

通过本教程，我们完成了：


Playwright的生态系统正在快速成熟，配合pytest的强大功能，可以构建企业级的自动化测试体系。建议下一步学习：


参考资料：
Playwright Python官方文档
Playwright Python GitHub

本教程基于Playwright v1.49+编写，如有更新请以官方文档为准。



欢迎光临 闲社 (https://fzgmgmantis.xianshe.com/) Powered by Discuz! X5.0