用 Playwright 做端到端测试入门
用 Playwright 做端到端测试入门
Playwright 是一个浏览器自动化库,能驱动 Chromium、Firefox、WebKit 三种内核,常用来写端到端(E2E)测试:模拟真实用户在页面里点击、输入、跳转,再断言结果是否符合预期。它自带"自动等待"机制,多数场景不需要手写 sleep。本文用 Python 版配合 pytest 插件走一遍完整流程。
安装
pip install pytest-playwright
playwright install
第一条装 Python 包与 pytest 插件,第二条下载三款浏览器内核。playwright install 只需执行一次。
第一个测试
装好插件后,测试函数声明一个 page 参数即可拿到浏览器页面对象,不必自己启动浏览器。新建 test_example.py:
from playwright.sync_api import Page, expect
def test_example(page: Page):
page.goto("https://example.com")
expect(page).to_have_title("Example Domain")
expect(page.get_by_role("heading", name="Example Domain")).to_be_visible()
运行 pytest。expect(...) 来自 playwright.sync_api,它会在断言失败前反复重试(默认超时 5 秒),所以页面还没加载完时不会立刻报错。
定位与交互
Playwright 推荐优先用面向用户的定位器:get_by_role、get_by_label、get_by_text,其次才是 CSS 选择器。下面的例子不依赖网络,可直接运行:
from playwright.sync_api import Page, expect
def test_fill_and_click(page: Page):
page.set_content("""
<label for="name">姓名</label>
<input id="name" />
<button type="button" onclick="
document.getElementById('out').textContent =
'你好 ' + document.getElementById('name').value
">提交</button>
<p id="out"></p>
""")
page.get_by_label("姓名").fill("张三")
page.get_by_role("button", name="提交").click()
expect(page.locator("#out")).to_have_text("你好 张三")
get_by_label 通过 <label> 关联到输入框,fill 会先聚焦再写入;click 触发脚本后,用 expect 断言段落文本。set_content 直接把一段 HTML 注入页面,适合写自包含的测试。
常用断言
expect 针对不同状态提供了对应方法:to_be_visible() 判断元素可见,to_have_text("...") 判断文本,to_have_value("...") 判断输入框当前值,to_have_count(3) 判断匹配到的元素个数,to_have_url("**/done") 判断地址跳转。多数方法也接受正则表达式,例如要确认列表恰好渲染出三条,可写 expect(page.locator(".item")).to_have_count(3)。断言失败时,报错信息会同时打印实际值与期望值,排查起来比手写 assert 直观得多。
等待与调试
多数等待由 expect 自动完成。确实需要等特定状态时,可用 page.wait_for_url("**/done") 等地址变化,或 locator.wait_for(state="visible") 等元素出现——尽量别用固定时长的 wait_for_timeout。调试时两个手段很实用:pytest --headed 让浏览器显示出来,慢动作运行;失败时 page.screenshot(path="fail.png", full_page=True) 存下整页截图。
小结
端到端测试的核心就三步:用面向用户的定位器找到元素,执行点击或输入,再用 expect 断言结果。装好 pytest-playwright 后,page fixture 省掉了浏览器生命周期管理,expect 的自动等待又省掉大部分手动 sleep。从一两个关键流程写起,比一上来就追求覆盖面更稳。

浙公网安备 33010602011771号