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

使用 Microsoft Playwright Testing 预览版的功能

重要

Microsoft剧作家测试将于 2026 年 3 月 8 日停用。 若要继续运行 Playwright 测试,请在 Azure 应用测试中创建新的 Playwright 工作区,现已正式发布。 了解如何迁移。

在本文中,你将了解如何使用 Microsoft Playwright Testing 预览版提供的功能。

重要

Microsoft Playwright Testing 目前以预览版提供。 有关 beta 版、预览版或尚未正式发布的 Azure 功能所适用的法律条款,请参阅 Microsoft Azure 预览版的补充使用条款

先决条件

背景

Microsoft Playwright Testing 预览版可用来:

  • 使用云托管浏览器并行运行测试来加速生成管道。
  • 将测试结果和工件发布到服务,使它们可轻松通过服务门户访问,从而简化故障排除。

这些功能有自己的定价计划,并且分开计费。 你可以选择使用任一功能或同时使用两者。 可以为工作区或任何特定运行启用或禁用这些功能。 若要详细了解定价,请参阅 Microsoft Playwright Testing 预览版定价

管理工作区的功能

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

  2. 选择工作区设置图标,然后转到“常规”页以查看工作区设置。

  3. 导航到“功能管理”部分。

    屏幕截图显示了 Playwright Testing 门户中有关功能管理的工作区设置页。

  4. 选择要为工作区启用的功能。

    目前,你可以选择仅启用或禁用该服务的报告功能。 默认情况下,报告功能针对工作区启用。

在运行测试时管理功能

你还可以选择为测试运行使用任一功能或同时使用两者。

重要

仅当为工作区启用了某个功能时,才能在测试运行中使用该功能。

  1. 在 Playwright 设置中,转到 playwright.service.config.ts 文件,并使用这些设置进行功能管理。
import { getServiceConfig, ServiceOS } from "@azure/microsoft-playwright-testing";
import { defineConfig } from "@playwright/test";
import { AzureCliCredential } from "@azure/identity";
import config from "./playwright.config";

export default defineConfig(
  config,
  getServiceConfig(config, {
    useCloudHostedBrowsers: true, // Select if you want to use cloud-hosted browsers to run your Playwright tests.
  }),
  {
    reporter: [
      ["list"],
      ["@azure/microsoft-playwright-testing/reporter"], //Microsoft Playwright Testing reporter
    ],
  },
);
  • useCloudHostedBrowsers设置用户帐户 :
    • 说明:此设置允许你选择是要使用云托管的浏览器还是客户端计算机上的浏览器来运行 Playwright 测试。 如果禁用此选项,则测试将在客户端计算机的浏览器上而不是云托管的浏览器上运行,并且不会产生任何费用。 你仍然可以配置报告选项。
    • 默认值:true
    • 示例:
      useCloudHostedBrowsers: true
      
  • reporter
    • 说明: 文件扩展你的设置的 Playwright 配置文件playwright.service.config.ts。 此选项将替代现有的报告程序并设置 Microsoft Playwright Testing 报告程序。 你可以添加或修改此列表,以包含你要使用的报告程序。 如果添加 @azure/microsoft-playwright-testing/reporter,则你需要为 Microsoft Playwright Testing 报告付费。 此功能可以独立于云托管浏览器使用,这意味着你不必在服务管理的浏览器上运行测试便可在 Playwright 门户上获得报告和生成工件。
    • 默认值:["@azure/microsoft-playwright-testing/reporter"]
    • 示例:
      reporter: [
      ["list"],
      ["@azure/microsoft-playwright-testing/reporter"]],
      
  1. 在 Playwright 设置中,转到 .runsettings 文件,并使用这些设置进行功能管理。
<?xml version="1.0" encoding="utf-8"?>
<RunSettings>
    <TestRunParameters>
        <!--Select if you want to use cloud-hosted browsers to run your Playwright tests.-->
        <Parameter name="UseCloudHostedBrowsers" value="true" />
    </TestRunParameters>
  <!-- NUnit adapter -->  
  .
  .
  .
    <LoggerRunSettings>
        <Loggers>
            <!--microsoft playwright testing service logger for reporting -->
            <Logger friendlyName="microsoft-playwright-testing" enabled="true" />
            <!--could enable any logger additionally -->
            <Logger friendlyName="trx" enabled="false" />
        </Loggers>
    </LoggerRunSettings>
</RunSettings>

  • UseCloudHostedBrowsers

    • 说明:此设置允许你选择是要使用云托管的浏览器还是客户端计算机上的浏览器来运行 Playwright 测试。 如果禁用此选项,则测试将在客户端计算机的浏览器上而不是云托管的浏览器上运行,并且不会产生任何费用。
    • 默认值:true
    • 示例:
      <Parameter name="UseCloudHostedBrowsers" value="true" />
      
  • reporter

    • 说明: 可以使用 microsoft-playwright-testing 记录器将测试结果和项目发布到服务。 可以通过从 .runsettings 中删除报告或将其设置为 false 来禁用报告。
    • 默认值:true
    • 示例:
      <Logger friendlyName="microsoft-playwright-testing" enabled="true" />