通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

教程：使用 Playwright Workspaces 运行端到端 Playwright 测试

本教程介绍如何将 Playwright 测试套件与 Playwright Workspaces 集成，以及如何使用云托管的浏览器更快地运行测试。 模拟 Playwright 测试套件，并将其连接到 Playwright Workspaces，以便加快执行速度。

在本教程中，你将：

  • 设置 Playwright 测试套件。
  • 将 Playwright 测试套件与 Playwright Workspaces 集成。
  • 通过该服务运行测试套件，以加快执行速度。

先决条件

  • 拥有有效订阅的 Azure 帐户。 如果没有 Azure 订阅，请在开始之前创建一个免费帐户。
  • 在本地计算机上安装的 Azure CLI。
  • Azure CLI 版本 2.2.0 或更高版本。 运行 az --version 以检查计算机上安装的版本。 如果需要安装或升级 Azure CLI，请参阅如何安装 Azure CLI。
  • Visual Studio Code。 如果尚未安装它，请下载并安装它。
  • Git。 如果尚未安装它，请下载并安装它。

先决条件检查

开始之前验证环境：

  1. 登录 Azure 门户，并检查订阅是否处于活动状态。

  2. 通过运行 az --version 在终端或命令窗口中检查 Azure CLI 版本。 有关最新版本，请参阅最新发行说明。

如果没有最新版本，请按照适用于你操作系统或平台的安装指南来更新安装。

设置 Playwright 测试套件

在此步骤中，你将创建一个与该服务集成的 Playwright 测试套件。

  1. 克隆示例存储库并导航到测试文件夹。
git clone https://github.com/Azure/playwright-workspaces
cd playwright-workspaces/samples/playwright-tests
  1. 安装依赖项。
npm install
  1. 运行 Playwright 测试。

运行此命令，在本地（服务外部）执行测试，以在与服务集成之前识别任何问题。 后续步骤中使用此项目来与服务集成。

npx playwright test

将 Playwright 测试套件与 Playwright Workspaces 集成

将你在上一教程中创建的 Playwright 测试套件与 Playwright Workspaces 服务集成。

按照以下步骤设置服务并集成测试套件。

创建 Playwright 工作区

要开始在云浏览器中运行 Playwright 测试，首先需要创建 Playwright 工作区。

  1. 登录到 Azure 门户。

  2. 选择门户左上角的菜单按钮，然后选择“创建资源”。

    显示用于创建新资源的 Azure 门户菜单的屏幕截图。

  3. 在搜索框中输入 Playwright Workspaces。

  4. 选择“Playwright Workspaces”卡，然后选择“创建”。

    显示包含 Playwright Workspaces 搜索结果的 Azure 市场搜索页的屏幕截图。

  5. 提供以下信息以配置新的 Playwright 工作区：

    字段 DESCRIPTION
    订阅 选择要用于此 Playwright 工作区的 Azure 订阅。
    资源组 选择现有资源组。 或者选择“新建”，然后为新资源组输入唯一名称。
    名称 输入唯一名称以标识工作区。
    该名称只能包含字母数字字符，长度介于 3 到 64 个字符之间。
    位置 选择要托管工作区的地理位置。
    此位置还决定了测试执行结果的存储位置。

    注释

    （可选）可以在“标记”选项卡上配置更多详细信息。标记是名称/值对，通过将相同的标记应用到多个资源和资源组，可以对资源进行分类并查看合并的账单。

  6. 完成资源配置后，选择“查看 + 创建”。

  7. 查看所有配置设置，然后选择“创建”以开始部署 Playwright 工作区。

    该过程完成后，会显示部署成功消息。

  8. 若要查看新工作区，请选择“转到资源”。

    显示 Azure 门户中部署完成信息的屏幕截图。

安装 Playwright Workspaces 包

若要安装服务包，请导航到你在上一教程中创建的测试套件的位置并运行以下命令：

npm init @azure/playwright@latest

此命令会生成一个 playwright.service.config.ts 文件，用于引导并验证 Playwright 与 Playwright Workspaces 之间的连接。

配置服务区域终结点

在设置中，必须提供区域特定的服务终结点。 终结点取决于在创建工作区时选择的 Azure 区域。

若要获取服务终结点 URL，请在 Azure 门户中导航到工作区。 然后，在“在设置中添加区域终结点”中，复制工作区的区域终结点。 终结点 URL 与创建工作区时选择的 Azure 区域匹配。 请确保此 URL 在 PLAYWRIGHT_SERVICE_URL 环境变量中可用。

配置你的环境

若要设置环境，必须使用在前面步骤中获取的值配置 PLAYWRIGHT_SERVICE_URL 环境变量。

建议使用dotenv模块管理环境。 使用dotenv，可以在.env文件中定义环境变量。

  1. 将dotenv模块添加到项目：

    npm i --save-dev dotenv

  2. 在 Playwright 项目中的 .env 文件旁边创建 playwright.config.ts 文件：

    PLAYWRIGHT_SERVICE_URL={MY-REGION-ENDPOINT}

    请务必将 {MY-REGION-ENDPOINT} 文本占位符替换为之前复制的值。

设置身份验证

要在 Playwright 工作区中运行 Playwright 测试，需要对使用该服务运行测试的 Playwright 客户端进行身份验证。 向你运行 Playwright 测试的开发工作站进行身份验证。

Microsoft Entra ID 是该服务的默认身份验证方法，也是建议的方法。 使用 Azure CLI 登录

az login

注释

如果你属于多个 Microsoft Entra 租户，请确保登录到你的工作区所属的租户。 可以从 Azure 门户获取租户 ID。 请参阅查找 Microsoft Entra 租户。 获取 ID 后，使用命令 az login --tenant <TenantID> 登录

大规模运行测试

现在，你已准备好使用 Playwright Workspaces 在云中运行 Playwright 测试的配置。

使用该服务运行 Playwright 测试

使用 Playwright Workspaces 时，会根据测试总分钟数付费。 如果你是第一次使用或通过免费试用版入门，则可以大规模运行单个测试（而不是完整测试套件），以避免耗尽免费试用限制。

按照以下步骤使用 Playwright Workspaces 运行 Playwright 测试：

  1. 打开终端窗口。

  2. 输入以下命令，在远程浏览器上运行 Playwright 测试套件，并将测试结果发布到工作区。

    npx playwright test --config=playwright.service.config.ts --workers=20

    测试完成后，可以在终端中查看测试状态。

    Running 600 tests using 20 workers
    600 passed (3m)

后续步骤

  • Last updated on