Azure Playwright 预览版

Azure Playwright 是一项完全托管的 Azure 服务，它使用云使你能够同时跨不同的作系统-浏览器组合运行并行化程度高得多的 Playwright 测试。 这意味着，使用更广泛的方案覆盖范围加快测试运行速度，这有助于加快功能交付速度，而不会牺牲质量。 通过该服务，还可以将测试结果和相关项目发布到服务，并在服务门户中查看它们，从而更快、更轻松地进行故障排除。 使用 Azure Playwright 服务，可以更快、更自信地发布功能。

准备好开始了吗？ 跳转到 快速入门指南！

有用链接

• 快速入门：大规模运行端到端测试
• 快速入门：跨不同浏览器和操作系统设置连续端到端测试
• 探索功能和优势
• 文档
• 定价
• 共享反馈

开始

按照以下步骤使用服务运行现有的 Playwright 测试套件。

先决条件

• 拥有有效订阅的 Azure 帐户。 如果没有 Azure 订阅，请在开始之前创建一个免费帐户。
• 必须为 Azure 帐户分配 所有者、参与者或经典管理员角色之一。
• Azure CLI 必须安装在运行 Playwright 测试的计算机中。

创建工作区

1. 使用 Azure 帐户登录到 Azure 门户。

2. 创建工作区。

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

     

   • 在搜索框中输入 Playwright Workspaces 。

   • 选择 剧作家工作区 卡，然后选择 创建。

     

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

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

     注释

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

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

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

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

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

     

安装 Azure Playwright 包

1. 运行以下命令以安装服务包

   npm init @azure/playwright
   

安装服务包将创建名为 playwright.service.config.ts 的服务配置文件

服务配置用于：

• 将 Playwright 定向到 Azure Playwright 服务并进行身份验证。
• 根据需要替代服务操作的超时。

确保项目使用 @playwright/test 1.47 或更高版本。

获取区域终结点

1. 在 Azure 门户中，复制 设置中“添加区域终结点”下的命令。

   

   终结点 URL 对应于工作区区域。 你可能会在 Azure 门户中看到不同的终结点 URL，具体取决于创建工作区时选择的区域。

设置环境

确保你在上一步中获取的 PLAYWRIGHT_SERVICE_URL 在环境中可用。

建议使用 dotenv 模块来管理环境。 使用 dotenv，你将使用 .env 文件来定义环境变量。

不要忘记将 .env 文件添加到 .gitignore 文件，以免泄露机密。

npm i --save-dev dotenv

.env 文件

PLAYWRIGHT_SERVICE_URL=wss://eastus.api.playwright.microsoft.com/playwrightworkspaces/workspace-id/browsers

设置身份验证

若要在 Azure Playwright 工作区中运行 Playwright 测试，需要对使用服务运行测试的 Playwright 客户端进行身份验证。 这可能是本地开发计算机或 CI 计算机。

该服务提供两种身份验证方法：Microsoft Entra ID 和访问令牌。

Microsoft Entra ID 使用 Azure 凭据，这需要登录到 Azure 帐户进行安全访问。 你也可以从 Playwright 工作区生成访问令牌并在设置中使用它。

使用 Microsoft Entra ID 设置身份验证

Microsoft Entra ID 是该服务的默认身份验证方法，也是建议的方法。 在本地开发计算机上，可以使用 Azure CLI 登录

az login

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

使用访问令牌设置身份验证

您可以从 Azure Playwright 工作区生成访问令牌，并在您的设置中使用它。 但是，我们强烈建议使用 Microsoft Entra ID 进行身份验证，因为它具有增强的安全性。 访问令牌虽然很方便使用，但其功能类似于长期密码，因此更容易泄露。

1. 若要使用基于访问令牌的身份验证，启用基于访问令牌的身份验证

2. 使用访问令牌设置身份验证

我们强烈建议使用 Microsoft Entra ID 对该服务进行身份验证。 如果使用访问令牌，请参阅 如何管理访问令牌

注意： 若要在 CI 管道中使用 Azure Playwright，需要从管道配置服务的身份验证，请参阅 跨不同浏览器和作系统设置持续的端到端测试

运行测试

使用上面创建的配置针对服务管理的浏览器运行 Playwright 测试。

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

后续步骤

• 在 CI/CD 管道中运行测试。

• 了解如何 管理对创建的工作区的访问。

• 试验不同数量的辅助角色以 确定测试套件的最佳配置。

贡献

此项目欢迎贡献和建议。 大多数贡献要求你同意参与者许可协议（CLA），声明你有权（实际这样做）授予我们使用你的贡献的权利。 有关详细信息，请访问 https://cla.opensource.microsoft.com。

提交拉取请求时，CLA 机器人会自动确定是否需要提供 CLA 并适当修饰 PR（例如状态检查、注释）。 只需按照机器人提供的说明进行操作。 只需使用 CLA 在所有存储库中执行此操作一次。

该项目已采用 Microsoft开源行为准则。 有关详细信息，请参阅 行为准则常见问题解答 或与 opencode@microsoft.com 联系，了解任何其他问题或意见。

商标

此项目可能包含项目、产品或服务的商标或徽标。 Microsoft 商标或徽标的授权使用必须遵循 Microsoft 的商标和品牌准则。 在此项目的修改版本中使用 Microsoft 商标或徽标不得造成混淆或暗示 Microsoft 赞助。 任何使用第三方商标或徽标都受这些第三方策略的约束。