技能 azure-microsoft-playwright-testing-ts
📦

azure-microsoft-playwright-testing-ts

低风险 ⚙️ 外部命令🌐 网络访问🔑 环境变量

在 Azure 云端浏览器上运行 Playwright 测试

在 Azure 云端托管的浏览器上扩展端到端浏览器测试,无需管理基础设施。与 CI/CD 流水线集成,并通过内置报告在 Azure 门户中查看结果。

支持: Claude Codex Code(CC)
🥉 72 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“azure-microsoft-playwright-testing-ts”。 使用默认配置设置 Azure Playwright 测试

预期结果:

创建 playwright.service.config.ts,包含用于身份验证的 createAzurePlaywrightConfig 和 DefaultAzureCredential,并在 Azure 报告器之前启用 HTML 报告器以确保正确的输出渲染。

正在使用“azure-microsoft-playwright-testing-ts”。 在 Azure 上使用 20 个并行工作进程运行测试

预期结果:

执行 npx playwright test --config=playwright.service.config.ts --workers=20,在云托管浏览器上分发测试,并在 Azure 门户中显示结果。

安全审计

低风险
v1 • 2/25/2026

Static analysis flagged 60 patterns but all are false positives from Markdown documentation. The skill contains TypeScript code examples for Azure Playwright Testing SDK. External command patterns are npm/bash examples in code blocks, not executable code. Network and environment variable access are legitimate Azure authentication patterns required for the service.

1
已扫描文件
308
分析行数
4
发现项
1
审计总数
低风险问题 (1)
Documentation Contains External Service URLs
The skill documentation includes Azure service endpoint URLs and references to external Microsoft APIs. These are legitimate service endpoints for Azure Playwright Workspaces but users should verify URLs match their workspace configuration.

风险因素

审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
88
安全
91
规范符合性

你能构建什么

企业 QA 团队扩展测试

在多个浏览器配置上并行运行大型测试套件,无需维护本地浏览器基础设施。将测试执行时间从数小时缩短到数分钟。

CI/CD 流水线集成

为 GitHub Actions 或 Azure Pipelines 添加云托管浏览器测试功能,支持自动身份验证和 Azure 门户中的结果报告。

跨浏览器兼容性测试

在 Azure 基础设施托管的 Chromium、Firefox 和 WebKit 浏览器上执行测试,环境一致。

试试这些提示

Azure Playwright 基础设置
帮助我为 TypeScript 项目设置 Azure Playwright 测试。我需要使用 Entra ID 身份验证配置包,并在云浏览器上运行现有的 Playwright 测试。
配置 CI/CD 流水线
创建一个 GitHub Actions 工作流,在 Azure Playwright 工作区上运行 Playwright 测试。包括 Azure 登录步骤、服务 URL 的环境变量,以及使用 20 个工作进程进行并行测试执行。
从旧包迁移
我的项目使用已弃用的 @azure/microsoft-playwright-testing 包。帮助我迁移到 @azure/playwright,更新配置、身份验证和报告器导入。
带工件的高级配置
配置 Azure Playwright 测试,包括重试时的跟踪收集、失败时的视频录制,以及 Azure 门户的自定义运行名称。使用 ServiceOS.LINUX 并将连接超时设置为 30 秒。

最佳实践

  • 使用 Entra ID 身份验证时,使用显式 credential 参数而非访问令牌以获得更好的安全性
  • 在配置中将 HTML 报告器列在 Azure 报告器之前,以确保正确生成报告
  • 启用跟踪和视频工件以调试失败,将 trace 设置为 on-first-retry

避免

  • 不要在配置文件中硬编码访问令牌 - 使用环境变量或 Azure Key Vault
  • 避免在工作进程不足的情况下运行测试 - 这会未充分利用 Azure 的并行执行能力
  • 使用 Azure 报告器时不要跳过 HTML 报告器 - Azure 报告器依赖于 HTML 报告器的输出

常见问题

@azure/playwright 和 @azure/microsoft-playwright-testing 有什么区别?
@azure/microsoft-playwright-testing 包已于 2026 年 3 月 8 日停用。新的 @azure/playwright 包需要显式 credential 参数,并使用 createAzurePlaywrightConfig 替代 getServiceConfig。
如何对 Azure Playwright 工作区进行身份验证?
本地开发使用 DefaultAzureCredential 进行 Entra ID 身份验证,CI/CD 使用 ManagedIdentityCredential。在本地运行测试前,请使用 az login 进行身份验证。
我需要哪个 Playwright 版本?
基本使用需要 Playwright 1.47 或更高版本。Azure 报告器功能需要 Playwright 1.57 或更高版本。
可以使用多少个并行工作进程?
Azure Playwright 工作区支持 20 个或更多并行工作进程,具体取决于工作区配置。使用 --workers=20 或更高版本以实现最佳并行执行。
我可以将其用于现有的 Playwright 测试吗?
是的,该技能封装了现有的 Playwright 配置。导入基础配置并使用 createAzurePlaywrightConfig 进行扩展,无需修改单个测试文件。
执行后如何查看测试结果?
测试结果将显示在 Azure 门户的 Playwright 工作区下。配置 Azure 报告器,并首先列出 HTML 报告器以生成本地 HTML 报告。