umbraco-skill-test-runner について
Umbraco スキルを検証する開発者向けの、スキル例テスト実行ツールです。ユニット、モック統合、エンドツーエンドのテストを実行し、プロジェクトルートに JSON レポートを出力します。
主な機能
- 01ユニット・モック・E2E テストの実行
- 02Web Test Runner と Playwright の利用
- 03必要に応じた Umbraco の自動起動
- 04JSON テストレポートの生成
活用シーン
- 01スキル例のコンポーネント・統合テストの検証
- 02Umbraco に対するエンドツーエンドテスト
インストール
コマンドをコピーしてターミナルで実行します。
$
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.jsonpackage.jsonrun-tests.ts詳細
スキルテストランナー
スキル例(ユニット、モック、E2E)からすべてのテストを実行し、JSON レポートを出力します。
使用方法
cd .claude/skills/umbraco-skill-test-runner/scripts
npm install --silent
npx tsx run-tests.ts
テストの種類
| 種類 | 説明 | ランナー |
|---|---|---|
| ユニット | @open-wc/testing を使用したコンポーネントテスト | Web Test Runner |
| モック | モック化されたバックオフィスに対する統合テスト | Playwright |
| E2E | 実際の Umbraco に対する完全なエンドツーエンドテスト | Playwright |
環境変数
| 変数 | デフォルト | 説明 |
|---|---|---|
UMBRACO_USER_LOGIN | - | E2E 認証用の管理者メールアドレス |
UMBRACO_USER_PASSWORD | - | E2E 認証用の管理者パスワード |
UMBRACO_URL | https://localhost:44325 | Umbraco インスタンスの URL |
Umbraco の自動起動
E2E テストが必要で、Umbraco が実行されていない場合、スクリプトは自動的に以下を実行します:
dotnet runを使用して./Umbraco-CMS.Skills/から Umbraco を起動します- インスタンスが準備完了になるまで待機します
- E2E テストを実行します
- 完了したら 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 であり、以下に続いて実行されます:
- リンク検証(
umbraco-skill-validator) - コード分析(
umbraco-skill-code-analyzer)
コメント
Markdown 対応