TestRail

TestRail はテスト管理とレポーティングの包括的なソリューションです。このスキルにより、Playwright テストを TestRail と統合し、テストケースを管理し、テスト結果を報告できます。

機能

• テストケース管理: TestRail 内でテストケースを作成・更新・削除
• テスト結果の報告: Playwright テスト実行から TestRail へテスト結果をレポート
• テストラン管理: テストラン、マイルストーン、プロジェクトの管理
• カスタムフィールド: テストケースにカスタム属性を追加・管理
• テスト統計: テストカバレッジと実行統計の取得

インストール

npm install @agent-skills/testrail

セットアップ

認証

TestRail API を使用するには、API キーを生成する必要があります。

1. TestRail インスタンスにログイン
2. アカウント設定 > API トークンに移動
3. API トークンを生成してコピー
4. 環境変数またはスキル設定で設定

import { TestRailSkill } from '@agent-skills/testrail';

const skill = new TestRailSkill({
  baseUrl: 'https://your-instance.testrail.io',
  username: 'your-email@example.com',
  apiKey: 'your-api-key'
});

使用例

テストケースの取得

const testCases = await skill.getTestCases({
  projectId: 1,
  suiteId: 2
});

テスト結果の追加

await skill.addResult({
  testRunId: 123,
  testCaseId: 456,
  statusId: 1, // 1 = passed, 5 = failed
  comment: 'Test execution completed',
  elapsed: '5m'
});

テストランの作成

const testRun = await skill.createTestRun({
  projectId: 1,
  suiteId: 2,
  name: 'My Test Run',
  description: 'Automated test execution'
});

プロジェクト情報の取得

const projects = await skill.getProjects();

ベストプラクティス

• API キーを安全に管理し、ソースコードにコミットしない
• バッチ操作で複数の結果を効率的に送信
• テストラン ID とテストケース ID をキャッシュして API 呼び出しを削減
• エラーハンドリングを実装して API 制限に対応

トラブルシューティング

認証エラー

• API キーと URL が正しいことを確認
• ユーザーが API アクセス権限を持つことを確認

レート制限

TestRail には API レート制限があります。大量の結果を送信する場合は、リクエストを遅延させる

テストケースが見つからない

プロジェクト ID、スイート ID、テストケース ID が正確であることを確認

参考資料

• TestRail API ドキュメント
• Playwright ドキュメント