跳至主要内容

安装

简介​

Playwright 的创建专门是为了满足端到端测试的需求。Playwright 支持所有现代渲染引擎，包括 Chromium、WebKit 和 Firefox。在 Windows、Linux 和 macOS 上进行测试，本地或在 CI 上，无头或有头，并具有原生移动模拟功能。

该 Playwright 库 可用作通用浏览器自动化工具，提供一套强大的 API 来自动化 Web 应用程序，适用于同步和异步 Python。

本简介介绍了 Playwright Pytest 插件，这是编写端到端测试的推荐方法。

您将学习

安装 Playwright Pytest​

Playwright 建议使用官方的 Playwright Pytest 插件 来编写端到端测试。它提供上下文隔离，开箱即用地在多个浏览器配置上运行。

开始安装 Playwright 并运行示例测试以查看其运行效果。

安装 Pytest 插件

pip install pytest-playwright

安装所需的浏览器

playwright install

添加示例测试​

创建一个遵循 test_ 前缀约定的文件，例如 test_example.py，放在当前工作目录或子目录中，其中包含以下代码。确保您的测试名称也遵循 test_ 前缀约定。

test_example.py
import re
from playwright.sync_api import Page, expect

def test_has_title(page: Page):
    page.goto("https://playwright.net.cn/")

    # Expect a title "to contain" a substring.
    expect(page).to_have_title(re.compile("Playwright"))

def test_get_started_link(page: Page):
    page.goto("https://playwright.net.cn/")

    # Click the get started link.
    page.get_by_role("link", name="Get started").click()

    # Expects page to have a heading with the name of Installation.
    expect(page.get_by_role("heading", name="Installation")).to_be_visible()

运行示例测试​

默认情况下，测试将在 chromium 上运行。这可以通过 CLI 选项 进行配置。测试在无头模式下运行，这意味着运行测试时不会打开浏览器 UI。测试结果和测试日志将显示在终端中。

pytest

更新 Playwright​

要将 Playwright 更新到最新版本，请运行以下命令

pip install pytest-playwright playwright -U

系统要求​

  • Python 3.8 或更高版本。
  • Windows 10+、Windows Server 2016+ 或 Windows 子系统 Linux (WSL)。
  • macOS 13 Ventura 或 macOS 14 Sonoma。
  • Debian 11、Debian 12、Ubuntu 20.04 或 Ubuntu 22.04、Ubuntu 24.04，在 x86-64 和 arm64 架构上。

后续步骤​