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

Microsoft Playwright Testing 预览版

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

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

有用的链接

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

入门

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

先决条件

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

创建工作区

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

2. 创建工作区。

   

   田	描述
   工作区名称	用于标识工作区的唯一名称。 名称不能包含特殊字符或空格。
   Azure 订阅	选择要在其中创建工作区的 Azure 订阅。
   区域	这是将存储工作区的测试运行数据的位置。

如果未看到此屏幕，请选择现有工作区并转到下一部分。

安装 Microsoft Playwright Testing 包

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

   npm init @azure/microsoft-playwright-testing
   

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

服务配置用于：

• 将 Playwright 直接身份验证到 Microsoft Playwright Testing 服务。
• 将Microsoft Playwright Testing 报告添加到配置中。
• 根据需要替代服务操作的超时。

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

获取区域终结点

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

   

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

设置环境

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

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

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

npm i --save-dev dotenv

.env 文件

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

设置身份验证

若要在Microsoft Playwright Testing 工作区中运行 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> 登录

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

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

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

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

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

注意： 若要在 CI 管道中使用Microsoft Playwright Testing，需要通过管道配置服务身份验证，请参阅 在不同的浏览器和操作系统之间设置连续端到端测试

运行测试

使用上面创建的配置针对服务管理的浏览器运行 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赞助。 任何使用第三方商标或徽标都受这些第三方策略的约束。