如何用 Playwright Python 三步搭起跨浏览器测试-平芜编程栈

如何用 Playwright Python 三步搭起跨浏览器测试

【免费下载链接】playwright-pythonPython version of the Playwright testing and automation library.项目地址: https://gitcode.com/GitHub_Trending/pl/playwright-python

凌晨两点，群里跳出一条消息：「这个按钮在 Safari 上点不动，Chrome 明明好的。」你打开 CI 看板才发现，整条测试流水线只跑 Chromium。手动开三个浏览器点一遍？不现实。Playwright Python 就是干这件事的：一套 Python API，同时驱动 Chromium、Firefox、WebKit 三大引擎，让同一套跨浏览器测试代码跑遍所有主流内核。

它凭什么比老方案强

传统 WebDriver 方案走的是 HTTP 指令通道，每个操作都要序列化一次、过一遍网络，慢且脆。Playwright 的差异化就三点：

单 API 覆盖三大引擎：Chromium / Firefox / WebKit 共用同一套方法签名，写一次page.click()，三边通用
协议层直连，速度快：不经过 WebDriver 的 HTTP 层，直接和浏览器内核通信，大批量异步操作的开销显著降低
内置智能等待：点击前自动等元素可交互、定位自动等元素出现，把"元素还没渲染出来"这类竞态问题挡在断言之前

从零跑起来

装好环境

两条命令的事。第一条装 Python 包，第二条下载三大浏览器内核的二进制（官方文档建议首次安装时再带上系统依赖）。

pip install playwright playwright install

playwright install会把三个引擎的浏览器下载到本机缓存目录。这里有个坑，踩过的都懂：Linux 服务器缺系统库时浏览器会直接起不来，需要再跑一次playwright install-deps补齐依赖。

写第一个用例

先看仓库自带的同步示例思路（scripts/example_sync.py）：遍历三种浏览器，各开一页截图存证。换成自己的页面就是下面这样——先跑本地静态页，不依赖任何外部服务，方便隔离问题。

from playwright.sync_api import sync_playwright with sync_playwright() as p: for bt in [p.chromium, p.firefox, p.webkit]: browser = bt.launch() page = browser.new_page() # 打开一个本地静态页（tests/assets 下有现成的空页） page.goto("file:///path/to/tests/assets/empty.html") # 三套引擎各存一张截图，肉眼即可比对渲染差异 page.screenshot(path=f"check-{bt.name}.png") browser.close()

with块退出时驱动进程自动回收，不用手写清理逻辑；三张截图放一起对比，谁的字距不对一眼就能看出来。想上异步风格，仓库scripts/example_async.py里就是同款写法的async/await版。

让它跑遍三套浏览器

单页脚本只是热身，真正要的是 pytest 级别的批量回归。这个仓库自己的测试套件（tests/下）就是范本：用例签名里带一个browser_name参数，由tests/conftest.py里的pytest_generate_tests钩子按参数展开，默认覆盖全部三套浏览器。

import pytest from playwright.sync_api import sync_playwright BROWSERS = ["chromium", "firefox", "webkit"] @pytest.mark.parametrize("browser_name", BROWSERS) def test_empty_page(browser_name: str) -> None: with sync_playwright() as p: browser = getattr(p, browser_name).launch() page = browser.new_page() page.goto("file:///path/to/tests/assets/empty.html") assert page.screenshot() # 三大引擎都应正常渲染 browser.close()

跑一下就是pytest -k empty_page，同一个用例自动在三个内核上各执行一遍。注意：这个仓库的官方套件还注册了--browser firefox这类命令行选项来缩窄范围，那是tests/conftest.py里pytest_addoption加的自定义参数，不在 pytest 内置能力里，想复用就照抄那几行。

别踩这几个坑 🕳️

Linux 上浏览器起不来：日志里一串libnss3之类的缺失 → 执行playwright install-deps补系统库，别自己装一堆 rpm
同步异步 API 混用：在async协程里调sync_api的阻塞方法，卡死协程且不报错 → 一个项目定死一种风格：脚本用sync_api，框架集成用async_api
WebKit 的 Windows 盲区：WebKit 内核不支持 Windows（本仓库README.md的兼容矩阵里也能确认）→ 给 Windows 用例加skip_webkit标记，别在 CI 里硬跑
无头模式渲染差异：headless 和 headed 的字体渲染不同，截图对比忽好忽坏 → 黄金截图必须和 CI 同一环境生成，这个仓库就是按golden-chromium/、golden-webkit/目录分内核存基线图的

一句话带走

回到开头那个凌晨两点：下次有人喊「Safari 上又坏了」，你可以把这条用例直接丢进三引擎的回归里，坏在哪个内核、坏成什么样，截图早就躺在报告里了。下一步就干一件事——挑 5 个核心页面，用上面三套代码各写一条用例，先跑 Chromium，再放行 Firefox 和 WebKit。

想抄作业的话，仓库里这几处值得翻：scripts/example_sync.py和scripts/example_async.py是最短完整示例，tests/下的官方测试套件展示了conftest.py参数化、skip_webkit标记、黄金截图对比这些工程化细节。

【免费下载链接】playwright-pythonPython version of the Playwright testing and automation library.项目地址: https://gitcode.com/GitHub_Trending/pl/playwright-python

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考