キャプチャ&リプレイ機能を使って操作した内容からテスト手順を作成しよう（Beta版）
はじめに
T-DASHは、日本語でテストケース作成・実行できるテスト自動化ツールです。
Ver.4.6.000で搭載されたキャプチャ&リプレイ機能により操作内容からテスト手順を作成できるようになりました。
本チュートリアルではキャプチャ&リプレイ機能の活用方法をお伝えします。
もくじ
制限事項
キャプチャ&リプレイ機能についてはBeta版でのご提供となります。
そのため、以下制限事項を設けています。あらかじめご了承ください。
- ご利用可能なプロジェクト：Webアプリのみ（Windowsアプリ、Androidアプリ [Beta版] ではご利用いただけません）
- 対象とするサイトの実装や操作内容次第で意図した操作が記録されない可能性があります
- 取得された画面要素（XPath）はテスト実行時に利用できない可能性があります
- 対象とするサイトの実装でスクリプトを用いて意図的にクリック動作を行われている場合、ユーザー操作と誤認識し手順化される可能性があります
2024年12月4日現在Windows版のみ提供となりますが、Mac版についても後日提供予定となっております。
操作方法
Webアプリプロジェクトでテストスイート画面を開き、キャプチャから手順化したいテストケースのデバッグボタンをクリックする。（キャプチャ&リプレイ機能はテストケースに対してのみ利用可能です）
デバッグ画面を開くとURL入力欄とキャプチャボタンを含めたデバッグ画面が表示される。
キャプチャ&リプレイ機能に関わる操作パネル内容説明
| UIイメージ | 名称 | 説明 |
|---|---|---|
 | URL入力欄 | 操作キャプチャでテスト手順化を行うサイトURLを入力する |
 | キャプチャ開始ボタン | URL入力欄で設定した内容でキャプチャ用ブラウザを起動しキャプチャを開始する |
 | キャプチャ停止ボタン | キャプチャを停止しキャプチャ用ブラウザを閉じる |
 | デバッグ開始ボタン | 手順化して、キャプチャした内容をデバッグ実行する |
操作をキャプチャしテスト手順を作成する（キャプチャ機能）
URL欄に操作を記録したいサイトのURLを入力し、右側にあるキャプチャボタンをクリックする。
Playwright未インストールの場合
キャプチャ機能はPlaywrightというフレームワークを用いて行います。初回利用時など、T-DASHでPlaywrightが利用できる状態でない場合は下記ダイアログが表示されます。「インストール」をクリックすることで追加インストールを行います。
（ご利用環境によりインストール完了まで時間が掛かる可能性があります。進捗状況はT-DASHコンソールで確認可能です）
T-DASHを表示しているブラウザとは別にキャプチャ用ブラウザが起動し、手順化する操作は新たに表示されたブラウザで行います。
キャプチャ用ブラウザ内の操作パネル内容説明
| UIイメージ（活性状態） | 名称 | 説明 |
|---|---|---|
 | 操作ボタン | キャプチャブラウザの操作がT-DASH側に反映される状態。 |
 | ポーズボタン | キャプチャブラウザの操作がT-DASH側に反映されない状態。 |
キャプチャ用ブラウザ内で操作を行うと、T-DASH側デバッグ画面に手順が追加されます。
操作に対応して追加されるテスト手順については、以下記事をご確認ください。
キャプチャブラウザ操作で追加されるテスト手順について（Beta版）
T-DASH側にデバッグ画面のキャプチャ停止ボタンをクリック、またはキャプチャ用ブラウザを閉じることでキャプチャ機能が終了します。
手順化されたキャプチャ内容を確認する（リプレイ機能）
キャプチャ操作から手順化された内容がデバッグ画面に反映されていることを確認し、手順を実行するブラウザを選択後「デバッグ開始」ボタンをクリックする。
選択していたブラウザが起動し、キャプチャ操作から手順化された内容が実行される。
テスト手順化されたキャプチャ内容はデバッグ画面に搭載されている各機能も利用可能となります。
詳細は以下記事をご確認ください。
デバッグ実行中に特定の手順で失敗する場合
キャプチャ操作から手順化された内容で実行に失敗した場合、以下内容が該当する可能性があります。いずれの場合もデバッグ画面から手順を編集することで解消可能です。
画面定義（XPath）に誤りがある
キャプチャ時点で取得できたXPathとテスト実行時のXPathが異なることがあり、テスト実行に失敗している可能性があります。該当するXPathをブラウザの開発者ツール、またはT-DASHのキャプチャツールを用いてXPathを取得し直してください。
取得したXPathを手順内の画面定義に適用することで正しい挙動に修正が可能です。
記録できていない手順、または不要な手順が存在する
Beta版では対象サイトの実装内容により手順が記録できない、また過剰に手順が記録される可能性があります。手順に過不足が存在することにより後続の処理が失敗している場合は、デバッグ画面内で手順追加・手順削除を行うことにより解消することができます。
チェックボックスに関する動作が存在する
キャプチャ対象サイトの実装内容によりチェックボックスに対する操作で反映される手順が異なる場合があります。デバッグ実行で失敗する場合、XPathを見直すことや手順を「要素をクリックする」に変更することで改善する可能性があります。
