Azure DevOpsテストプランサービス

@gmangiapelo/wdio-azure-devops-serviceはサードパーティパッケージです。詳細については、GitHub | npmをご覧ください。

Azure DevOpsテストプランにWebdriverIOの結果を公開します。

主な機能

• Jasmine/Jest/MochaおよびCucumberランタイムフレームワークのサポート
• 複数のspec（テスト）ファイルを実行し、それらが同じスイートに属する場合、テスト結果は同じテスト実行下に集約されます。
• 単一テスト実行後すぐに結果が報告されます（リアルタイムレポート）。
• 最後のspec（テスト）ファイルが終了すると、テスト実行が閉じられます。
• 複数スイートのサポート

インストール

(開発用)依存関係として使用するのに、次のコマンドでこのモジュールをローカルにインストールします。

npm install --save @gmangiapelo/wdio-azure-devops-service
npm install --save-dev @gmangiapelo/wdio-azure-devops-service

WebdriverIOのインストール方法はこちらをご覧ください。

使用方法

wdio-azure-devops-serviceはNodeJS 8以降をサポートしています。

wdio-azure-devops-serviceはcommonjsとesmをサポートしています。

設定

@gmangiapelo/wdio-azure-devops-serviceはサービスであるため、次のようにwdio.conf.jsファイルで設定できます。

import AzureDevopsService from "@gmangiapelo/wdio-azure-devops-service";
// wdio.conf.js
exports.config = {
    // ...
    // =====
    // Setup
    // =====
    services: [
        [
              AzureDevopsService,
              {
                  pat: 'u46xjx2ol4px36zg3z565uz52dbvshctlulkhrsecxiamn6nhtwa',
                  organizationUrl: 'https://dev.azure.com/gianlucamangiapelo',
                  projectId: '8b3c68ac-f69d-41c6-bbad-921d8bae9819',
                  planId: 263072,
                  suiteId: 263073,
                  caseIdRegex: '@?[ref](https://github.com/gianlucamangiapelo/wdio-azure-devops-service/blob/main/\\d+)',
                  runName: 'FE regression tests for TestPlan',
              },
          ],
    ],
    // ...
};

テストケースの設定

WDIOテストには、AzureテストケースのIDを含める必要があります。テストケースのIDはテストタイトルとは区別してください。

Mochaスタイル

// Good:
it("C123 Can authenticate a valid user", ...

// Bad:
it("C123Can authenticate a valid user", ...
it("Can authenticate a valid user C123", ...

Cucumberスタイル

## Good:
@C123
Scenario Can authenticate a valid user
@c123
Scenario Can authenticate a valid user,

## Bad:
@c123stringTest
Scenario Can authenticate a valid user

Azure DevOpsレポート例

これは、テスト実行中にAZテストプランにプッシュされた結果の例です。

サービスオプション

pat

API権限が設定されたAzure DevOpsで生成された個人用アクセス トークン。

例: "u46xjx2ol4px36zg3z565uz52dbvshctlulkhrsecxiamn6nhtwa"

型: 文字列

必須: true

organizationUrl

Azure DevOpsインスタンスのベースURL。

例: "https://dev.azure.com/gianlucamangiapelo"

型: 文字列

必須: true

projectId

Azure DevOpsプロジェクトのID。

projectIdを見つけるには、GET {organizationUrl}/_apis/projects?api-version=6.0を使用し、適切なidをコピーします。

例: "3cf7dbc9-cb1e-4240-93f2-9a5960ab3945"

型: 文字列

必須: true

planId

Azure DevOpsテストプランセクションで取得できるtest plainId。

例: 124

型: 整数

必須: true

suiteId

Azure DevOpsテストプランセクションで取得できるsuiteId。ネストされたスイートの場合、ルートsuiteIdを取得します。サービスはすべての子スイートを反復処理します。

例: 21

型: 整数

必須: true

runName

テスト実行の説明的な名前。

例: "FE回帰テスト実行"

型: 文字列

必須: true

caseIdRegex

タグまたはタイトルのテストケースからtestCaseIdを照合するためのカスタム正規表現。

型: 文字列

デフォルト: "@?[cC](https://github.com/gianlucamangiapelo/wdio-azure-devops-service/blob/main/\d+)"

必須: false

作成者

Gianluca Mangiapelo - github