mcpField
U
umbraco-skill-test-runner

umbraco-skill-test-runner

github.com/umbraco测试与质量27376 次安装6 周前更新
代码仓库

关于 umbraco-skill-test-runner

用于运行 skill 示例测试的工具，面向验证 Umbraco skills 的开发者。它执行单元、模拟集成和端到端测试，并在项目根目录生成 JSON 报告。

主要功能

  1. 01运行单元、模拟和端到端测试
  2. 02使用 Web Test Runner 与 Playwright
  3. 03需要时自动启动 Umbraco
  4. 04生成 JSON 测试报告

适用场景

  1. 01验证 skill 示例中的组件与集成测试
  2. 02对运行中的 Umbraco 执行端到端测试

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/umbraco/umbraco-cms-backoffice-skills --skill umbraco-skill-test-runner

安装后在 Claude Code 中输入/umbraco-skill-test-runner确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

scripts/
package-lock.json
package.json
run-tests.ts

详细介绍

Skill Test Runner

运行技能示例中的所有测试（单元测试、模拟测试、端到端测试），并输出 JSON 报告。

用法

cd .claude/skills/umbraco-skill-test-runner/scripts
npm install --silent
npx tsx run-tests.ts

测试类型

类型说明运行器
单元测试使用 @open-wc/testing 的组件测试Web Test Runner
模拟测试针对模拟的 backoffice 进行集成测试Playwright
端到端测试针对真实 Umbraco 进行完整端到端测试Playwright

环境变量

变量默认值说明
UMBRACO_USER_LOGIN-用于端到端测试身份验证的管理员邮箱
UMBRACO_USER_PASSWORD-用于端到端测试身份验证的管理员密码
UMBRACO_URLhttps://localhost:44325Umbraco 实例 URL

自动启动 Umbraco

如果需要运行端到端测试，且 Umbraco 尚未运行，脚本将自动：

  1. 使用 dotnet run 从 ./Umbraco-CMS.Skills/ 启动 Umbraco
  2. 等待实例就绪
  3. 运行端到端测试
  4. 完成后停止 Umbraco（如果是由脚本启动的）

输出

在项目根目录生成 test-report.json，其结构如下：

{
  "timestamp": "2024-12-26T12:00:00Z",
  "umbracoStarted": true,
  "summary": {
    "total": 10,
    "passed": 8,
    "failed": 1,
    "skipped": 1
  },
  "results": [
    {
      "example": "counter-dashboard",
      "path": "plugins/umbraco-testing-skills/.../counter-dashboard",
      "type": "unit",
      "status": "passed",
      "duration": 1234
    }
  ]
}

集成

此技能是 validate-skills 命令的第 3 阶段，运行顺序如下：

  1. 链接验证（umbraco-skill-validator）
  2. 代码分析（umbraco-skill-code-analyzer）

评论

支持 Markdown