Playwright 测试自动化

Playwright 自动化作为 Test Manager 自动化类型与 Studio 创作的自动化一起使用，而无需重写 Studio 中的现有测试套件。

备注：

This capability is in controlled availability, delivered only to eligible tenants. It is available in Test Manager only when delivered through Test Cloud, and UiPath must enable it for your tenant before it works — contact your UiPath account team with your tenant details to request enablement.

除了 Studio 创作的 (机器人) 自动化之外，Test Manager 还可以执行由Playwright自动化支持的测试用例。已在 Playwright 中编写端到端测试的团队可以将这些测试引入 Test Manager，以进行编排、计划、报告和可追踪性，而无需在 Studio 中重写。

Playwright 自动化端到端工作方式

Playwright 测试项目位于 UiPath 之外其自己的来源控件系统中。之后，自动化通过以下流程到达 Test Manager：

1. 使用 UiPath 命令行接口 (CLI) 的tm pack命令将项目打包到 UiPath 自动化包中，然后发布到 Orchestrator 的全局租户范围包订阅源或文件夹级别的专用订阅源。有关打包步骤，请参阅为 Test Manager 打包 Playwright 项目。
2. 已发布的包可以在 Test Manager 中选择，就像通过选择自动化流程选择 Studio 发布的自动化一样。
3. 如果包是使用 Test Manager 项目密钥构建的，则在 Test Manager 提取包后，系统将自动创建匹配的测试用例，并且 Playwright 自动化会自动链接到每个用例。否则，系统将使用与 Studio 自动化相同的流程单独创建测试用例，并手动链接自动化。
4. 从此时开始，测试用例的行为与 Test Manager 中的任何其他自动化测试用例类似：可以将其放置到测试集中，按需或按计划触发，其结果、工件和可追溯性链接与其他所有测试用例一起显示。

Test Manager 从 Playwright 项目中捕获的内容

“Test Manager”字段	来自剧作者
名称和字段说明	仅测试标题。包元数据没有说明字段，因此未填充说明。
标签	@tag / 注释值（例如 resilience、observability），作为标签复制到测试用例上，用于筛选和测试集范围设定。
项目/规范文件	测试所属的 Playwright 项目（来自 playwright.config.ts）和规范文件，作为元数据捕获。每个测试创建一个测试用例，每个项目都没有扇出。
来源（选择“自动化”选项卡）	来源值为Playwright或UiPath ，显示在“选择自动化”选取器中。

备注：

名称和字段说明、标签和项目/规范文件在测试用例中全部实现为自动生成的系统标签。仅来源是一个单独的字段，在“选择自动化”选取器中显示为自己的列，而不是显示为标签。

术语

• 在 Test Manager 中，自动化和测试用例仍然是不同的工件类型。
• 自动化（无论是 Playwright 还是 Studio）会分配给测试用例。
• Playwright 测试本身从不称为测试用例。

执行和报告对等

分配后，Playwright 支持的测试用例的执行、计划和报告与 Studio 编写的测试用例完全相同：相同的触发器、相同的测试集成员身份规则、相同的结果和可追溯性视图。

已知限制

限制	它的含义是什么
仅限 Chromium	执行 Pod 仅安装 Chromium。仍可以选择配置为使用 Firefox 或 Webkit 的项目，但运行不会在该浏览器上执行。
仅适用于 Serverless 执行	Playwright 测试仅在 UiPath Serverless 基础架构上运行，每次运行使用专用的 Pod。尚不支持在内部部署或本地执行机器人。
仅限 Node.js (JavaScript/TypeScript)	仅基于 Node.js支持剧作者项目。不支持 playwright-python、playwright-java 和 playwright-dotnet 项目。
需要独立项目	每个项目都必须在独立的目录中打包，其依赖项可在打包的根目录中解析。单一存储库子文件夹仅在独立时才有效。
无断言级详细信息	Test Manager 不会单独公开 Playwright 的断言。它依赖于 Playwright 自己的每次尝试通过/失败结果和配置的附件。
无需导入外部运行结果	无法导入在 Test Manager 外部（例如在客户自己的 CI 中）运行的 Playwright 套件的结果。
每次执行单个作业	All test cases in one Playwright test set execution run within a single Orchestrator job — an oversized test set risks a job timeout.
Execution time limit	A Playwright test set execution has a 45-minute time limit, separate from the video-recording time limits that apply elsewhere in Test Manager.
无多 Pod 分片	整个套件每次执行都在一个 Pod 中运行。Playwright 自己的工作器并行度将按配置应用，但 Pod 之间的分布式分片功能尚不可用。
无设施报告	Playwright 设备 (test.extend()) 正常运行，但 Test Manager 不会使用测试用例级或按设备的报告对其进行建模。
无法进行自我修复	Playwright 自动化尚不支持智能体自我修复功能。
无强制执行顺序	测试用例顺序遵循 playwright.config.ts。在 Playwright 测试集上启用“强制执行顺序” 、 “RPA 活动覆盖率”或“Healing Agent”会导致快速执行失败。
禁止跨包或跨版本混合	若在一个测试集中混合使用两个不同 Playwright 包或同一包的两个不同版本中的测试用例，此功能会被阻止。
数据驱动的测试集在每个变体中运行	参数化 Playwright 测试的每个变体都是其自己的测试用例。向测试集添加一种变体将运行该测试的所有变体。
不得使用 UiPath 录制视频或实时流式传输	在 Playwright 测试集上启用视频录制无效，并且“录制”选项卡和“实时流”操作未显示任何数据。Playwright 自己的视频捕获（use: { video } 中的 playwright.config.ts）不受影响 — 这些 .webm 文件仍作为工件附加。

许可

通过 Test Manager 运行 Playwright 测试所消耗的平台容量与任何其他无服务器测试执行相同，在底层机器人执行级别 — Playwright 与原生 UiPath 测试自动化的消耗率没有不同。有关详细信息，请参阅Unified Pricing：许可 Test Manager 。

相关内容

• Playwright 工件捕获的工作方式
• 打包适用于 Test Manager 的 Playwright 项目
• 为 Playwright 测试配置工件捕获
• 选择自动化