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