用 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。从一两个关键流程写起,比一上来就追求覆盖面更稳。

posted @ 2026-11-20 08:43  徽音说AI搜索  阅读(0)  评论(0)    收藏  举报