### 结合 Python、Playwright 和 Allure 进行测试 在 Python 中结合 Playwright 和 Allure 框架进行测试是一种高效的方式，能够帮助开发者构建强大的 Web UI 测试解决方案。以下是详细的说明以及实现方法。 #### 使用 Playwright 的基本配置 Playwright 是一个多浏览器自动化工具，支持 Chromium、Firefox 和 WebKit 等主流浏览器。通过 `sync_api` 或 `async_api` 可以轻松控制浏览器行为[^1]。 为了初始化浏览器实例，在测试前需要创建一个 fixture 来管理浏览器生命周期： ```python @pytest.fixture(scope="module") def browser(): from playwright.sync_api import sync_playwright with sync_playwright() as p: browser = p.chromium.launch(headless=False) # 设置 headless=True 表示无头模式运行 yield browser browser.close() ``` 此代码片段展示了如何启动一个非无头模式的 Chromium 实例，并在其作用域结束时关闭它[^1]。 #### 页面上下文与页面对象管理 除了全局的浏览器实例外，还需要为每个测试用例单独提供独立的页面上下文和页面对象。这可以通过另一个 fixture 实现： ```python @pytest.fixture(scope="function") def page(browser): context = browser.new_context() page = context.new_page() yield page page.close() ``` 这段代码确保每次执行测试函数时都会获得一个新的页面实例，从而避免不同测试之间的干扰[^3]。 #### 整合 Allure 报告功能 Allure 提供了一种优雅的方式来生成结构化的 HTML 测试报告。要将其融入基于 Pytest 的 Playwright 测试流程中，需引入相应的装饰器来标记 Feature 和 Story 层级的信息[^1]: ```python @pytest.mark.allure_feature("Web UI Testing") # 定义测试特性 @pytest.mark.allure_story("Verify Example Domain") # 描述具体的业务场景 def test_example_with_allure(page: Page): with allure.step("Navigate to example.com"): page.goto("https://www.example.com") with allure.step("Check page title"): title = page.title() assert title == "Example Domain", f"Expected 'Example Domain', got '{title}'" with allure.step("Verify 'More information...' text is visible"): expect(page.get_by_text("More information...")).to_be_visible() ``` 以上代码利用了 Allure 的 step 功能记录每一步的操作逻辑，使得最终生成的报告更加清晰易读[^1]。 #### 自动生成 Allure 报告 完成测试脚本编写后，可通过命令行参数触发 Allure 报告生成功能。例如： ```bash pytest --alluredir=./results allure serve ./results ``` 第一条指令指定存储临时数据的位置；第二条则会即时打开浏览器展示完整的交互式报表界面[^2]。 #### 错误处理与 Trace 日志保存 当某些复杂操作失败时，捕获异常并附加额外诊断信息至关重要。可以在 conftest 文件中的 teardown 阶段加入 trace 记录机制： ```python @pytest.hookimpl(hookwrapper=True) def pytest_runtest_makereport(item, call): outcome = yield report = outcome.get_result() if report.when == 'call' and report.failed: page = item.funcargs['page'] page.screenshot(path=f"screenshots/{item.name}.png") page.context.tracing.stop(path=f"traces/{item.name}.zip") ``` 这样即使遇到问题也能快速定位原因所在[^3]。 --- ###