HTML Modules

HTML 向けのテクノロジー固有の Modules は、特定のブラウザ自動化タスクを実行します。

ウェブページのアクセシビリティをチェック

ウェブページがどれだけユーザーにとって利用しやすいかをテストします。検索条件として、少なくともタイトル、URL、またはウィンドウインデックスのいずれかを指定する必要があります。

値

説明

タイトル

操作したいブラウザウィンドウのキャプションです。

ワイルドカード * を追加することも可能です。ブラウザウィンドウに開いているタブのみを使用したい場合は、* を入力してください。

URL

誘導したいページの URL。例：http://support.tricentis.com

ウィンドウインデックス

複数のウィンドウが前の条件に一致する場合に、操作するブラウザウィンドウのインデックス。

これらの値のいずれかを指定します：

integer：このインデックスは、ウィンドウが開かれた時系列の順序を指し、画面上の表示順ではありません。
last: この値は最後に開いたウィンドウを表す値です。

Execute JavaScript

ウェブページ上で JavaScript 呼び出しを実行します。検索条件として、少なくともタイトル、URL、またはウィンドウインデックスのいずれかを指定する必要があります。

値	説明
タイトル	操作したいブラウザウィンドウのキャプションです。ワイルドカード * を追加することも可能です。ブラウザウィンドウに開いているタブのみを使用したい場合は、* を入力してください。
URL	誘導したいページの URL。例：http://support.tricentis.com
ウィンドウインデックス	複数のウィンドウが前の条件に一致する場合に、操作するブラウザウィンドウのインデックス。これらの値のいずれかを指定します： integer：このインデックスは、ウィンドウが開かれた時系列の順序を指し、画面上の表示順ではありません。 last: この値は最後に開いたウィンドウを表す値です。
JavaScript	return と入力し、結果を確認する JavaScript ステートメントを入力します。文字列に二重引用符"が含まれている場合は、追加で 2 組の引用符を付けてエスケープする必要があります。例：window.location.href="""http://support.tricentis.com"""
結果	JavaScript 呼び出しの期待される戻り値です。

JavaScript の結果を検証します。

Javascript 呼び出しの結果を検証します。例えば、ブラウザのクッキーや JavaScript 変数の値を取得して検証できます。検索条件として、少なくともタイトル、URL、またはウィンドウインデックスのいずれかを指定する必要があります。

値

説明

タイトル

操作したいブラウザウィンドウのキャプションです。

ワイルドカード * を追加することも可能です。ブラウザウィンドウに開いているタブのみを使用したい場合は、* を入力してください。

URL

誘導したいページの URL。例：http://support.tricentis.com

JavaScript

実行するステートメントを返します。

文字列に二重引用符"が含まれている場合は、追加で 2 組の引用符を付けてエスケープする必要があります。

例：window.location.href="""http://support.tricentis.com"""

OpenUrl

ブラウザでウェブサイトを開きます。

値	説明
URL	開きたいURLです。
UseActiveTab	TRUEに設定すると、Tosca Cloudは、このモジュールに基づくテストステップを実行する際に、開いているブラウザウィンドウを探します。開いているブラウザが見つかった場合、そのブラウザのアクティブタブで URL を開きます。Tosca Cloudが開いているブラウザを見つけられない場合、URL を新しいブラウザウィンドウで開きます。 Falseまたは空に設定されている場合、Tosca Cloudは、他に開いているウィンドウがない場合にのみ、URL を新しいブラウザウィンドウで開きます。開いているウィンドウがある場合、Tosca Cloudはそのウィンドウを再利用します。
ForcePageSwitch	TRUEに設定すると、Tosca Cloudは、URL が開くまでこのモジュールのアクションを繰り返します。これには、値 UseActiveTab もTRUE に設定されている必要があります。 False または空に設定されている場合、Tosca Cloud は、指定された URL を 1 回だけ開こうとします。この値は Internet Explorer ではサポートされていないため、False に設定する必要があります。
BrowserArguments->Argument	ブラウザを起動するためのコマンドライン引数。複数の引数を使用したい場合は、それぞれの引数を別々のテストステップの値に入力してください。引数はブラウザごとに異なることに注意してください。

埋め込まれたChrome/Chromiumアプリケーションを開く

WebDriverを使用して、ChromeまたはChromiumを埋め込んだアプリケーションを開きます。

値	説明
アプリケーションパス	操作したいアプリケーションのフルパス（ファイル名と拡張子を含む）です。
Window Classname	メインアプリケーションウィンドウのクラス名です。この値は任意です。アプリケーションウィンドウの検索を高速化します。
WebDriverサーバーパス	Path to the chromedriver.exe that you want to use.この値は任意です。
URL	アプリケーションを開いた後に表示したい URL です。この値は任意です。
引数	読み取り専用。ここには何も入力できません。
Arguments->Argument	アプリケーションに転送したい引数です。この値は任意です。

ClickOnScreen

このモジュールを使用して、次の操作を実行できます。

Web ブラウザ内の指定位置をクリックします。
AndroidのChromeおよびiOSのSafariのモバイルブラウザで指定された位置をクリックします。モバイルブラウザ用にこのモジュールを使用する場合、Tosca Cloudは仮想キーボードを閉じます。
モバイルデバイスの画面で指定された位置をタップします。

値	説明
キャプション	クリックしたいタブのキャプション。
X	X座標をパーセントで指定します。最も左の値は0 、最も右の値は 100 です。
Y	y座標をパーセントで指定します。上端の値は 0、下端の値は 100 です。

CloseBrowser

ブラウザのタブを閉じます。

値	説明
タイトル	閉じたいタブのキャプションです。ワイルドカードを使用できます。

Chrome/Chromiumアプリケーションに接続します

WebDriverを使用して、ChromeまたはChromiumを埋め込んだアプリケーションに接続します。

値	説明
デバッグポート	デバッグポートアプリケーション。
WebDriverサーバーパス	Path to the chromedriver.exe that you want to use.この値は任意です。
Window Classname	メインアプリケーションウィンドウのクラス名です。この値は任意です。アプリケーションウィンドウの検索を高速化します。

Start HTML Log Monitoring

コンソールログまたはネットワークログのいずれかの追跡を開始します。アプリケーションをデバッグする際に、この機能をご利用いただけます。このモジュールは、Google ChromeおよびMicrosoft Edgeブラウザのみをサポートしています。検索条件として、少なくともタイトル、URL、またはウィンドウインデックスのいずれかを指定する必要があります。

値	説明
タイトル	操作したいブラウザウィンドウのキャプションです。ワイルドカード * を追加することも可能です。ブラウザウィンドウに開いているタブのみを使用したい場合は、* を入力してください。
URL	誘導したいページの URL。例：http://support.tricentis.com
ウィンドウインデックス	複数のブラウザウィンドウが前の条件に一致する場合に、操作するブラウザウィンドウのインデックス。これらの値のいずれかを指定します： <integer>：このインデックスはウィンドウの視覚的な並び順ではなく、開いた時刻のみを参照します。 last: この値は最後に開いたウィンドウを表す値です。
ログタイプ	誘導するページで実行するログ監視のタイプ。これらの値のいずれかを指定します：ブラウザの DevTools 内のコンソールタブに関連するコンソールログです。ブラウザの DevTools 内のネットワークタブに記録されたメッセージに関連するネットワークログです。

HTML ログ監視を停止します

開始していたコンソールログまたはネットワークログの追跡を停止し、監視データを取得します。アプリケーションをデバッグする際に、この機能をご利用いただけます。このモジュールは、Google ChromeおよびMicrosoft Edgeブラウザのみをサポートしております。検索条件として、少なくともタイトル、URL、またはウィンドウインデックスのいずれかを指定する必要があります。

値	説明
タイトル	操作したいブラウザウィンドウのキャプションです。ワイルドカード * を追加することも可能です。ブラウザウィンドウに開いているタブのみを使用したい場合は、* を入力してください。
URL	誘導したいページの URL。例：http://support.tricentis.com
ウィンドウインデックス	複数のブラウザウィンドウが前の条件に一致する場合に、操作するブラウザウィンドウのインデックス。これらの値のいずれかを指定します： <integer>：このインデックスはウィンドウの視覚的な並び順ではなく、開いた時刻のみを参照します。 last: この値は最後に開いたウィンドウを表す値です。
ログタイプ	誘導するページで実行するログ監視のタイプ。これらの値のいずれかを指定します：ブラウザの DevTools のコンソールタブを参照するコンソールログ。 DevToolsブラウザのネットワークタブに記録されたメッセージを参照するネットワークログ。
ログファイル経路	開始タスクと停止タスクの間に発生したログエントリを含むレポートファイルを保存する場所です。ログ種別に基づいて、異なるログファイルを生成します。コンソールログ用のプレーンテキストファイル。ネットワークログのJSONファイル。フォルダパスを指定します。

Steer Dialog Box

アプリケーション内の JavaScriptダイアログボックスを制御し、テストの精度を向上させます。検索条件として、少なくともタイトル、URL、またはウィンドウインデックスのいずれかを指定する必要があります。

ダイアログボックスを操作する前に、ページを操作する必要があることに注意してください。

値	説明
タイトル	操作したいブラウザウィンドウのキャプションです。ワイルドカード * を追加することも可能です。ブラウザウィンドウに開いているタブのみを使用したい場合は、* を入力してください。
URL	誘導したいページの URL。例：http://support.tricentis.com
ウィンドウインデックス	複数のブラウザウィンドウが前の条件に一致する場合に、操作するブラウザウィンドウのインデックス。これらの値のいずれかを指定します： <integer>：このインデックスはウィンドウの視覚的な並び順ではなく、開いた時刻のみを参照します。 last: この値は最後に開いたウィンドウを表す値です。
確定	確認ダイアログに送信したい応答です。これらの値のいずれかを指定します。 TRUE:応答は OK です。 False:応答は Cancel です。
PromptText	プロンプトダイアログのテキスト入力フィールドに入力したいテキストです。

Check Webpage for Broken Links

クライアントエラー（400～499）またはサーバーエラー（500～599）を返すリンクがないかをチェックします。これにより、ページ上にリンク切れがないことを確認できます。

Tosca Cloud が、既存のブラウザセッションを使用してエラー応答を検証できることに注意してください。つまり、確認するリンクを含む Web ページは、検証時に開いている必要があります。

検索条件として、少なくともタイトル、URL、またはウィンドウインデックスのいずれかを指定する必要があります。

値	説明
タイトル	ページの HTML タイトルを使用して、確認するリンクを含む Web ページを識別します。ワイルドカード * を追加することも可能です。ブラウザウィンドウに開いているタブのみを使用したい場合は、* を入力してください。
URL	現在開いているページの URL を使用して、検証したいリンクを含む Web ページを特定します。例：http://support.tricentis.com
Window Index	操作したいブラウザウィンドウのインデックスを使用して、検証したいリンクを含む Web ページを特定します。これらの値のいずれかを指定します： <integer>：このインデックスはウィンドウの視覚的な並び順ではなく、開いた時刻のみを参照します。 last: この値は最後に開いたウィンドウを表す値です。
Ignore Errors	この検証で特定の応答エラーを無視したい場合は、エラーコードを指定します。たとえば、403（“Forbidden”）の応答を無視したい場合は、403 と入力します。この場合、Tosca Cloudは、検証中の 403 応答エラーをすべて無視します。

Read Web QR/Barcode

ブラウザ内の任意の QR コードまたはバーコードを検証またはバッファします。

このモジュールが QR コードを読み取るには、既存のブラウザセッションで動作する必要があることに注意してください。つまり、読み取りたい QR コードまたはバーコードを含む Web ページは、検証時に開いている必要があります。

値	説明
タイトル	検証またはバッファしたい QR コードまたはバーコードを含む Web ページの HTML タイトルです。ワイルドカードを使用できます。例えば、ブラウザウィンドウで唯一開いているタブを使用するには、*を入力してください。
URL	検証またはバッファしたい QR コードまたはバーコードを含む、現在開いている Web ページの URL です。例：http://support.tricentis.com
Window Index*	検証またはバッファしたい QR コードまたはバーコードを含むブラウザウィンドウのインデックスです。こちらのいずれかの値を使用できます: 開いたウィンドウのうち、<n>番目のウィンドウかを示す番号です。</n>たとえば、3 を指定すると、開いた 3 番目のウィンドウを操作対象として定義します。正の整数を入力してください。 last を指定すると、最後に開いたウィンドウを定義します。
タイプ	確認するまたはバッファするコードの種類を選択します。こちらのいずれかの値を使用できます: QR バーコードすべて
インデックス	検証またはバッファしたい QR コードまたはバーコードのインデックス位置です。たとえば、3 を入力すると、ページ上の 3 番目の QR コードを検証できます。ページ上のすべての QR コードおよびバーコードを検証またはバッファする場合は、インデックスを省略します。
値	検証する期待値を入力します。例：http://www.example.com/download
* テストケースには、Tosca Cloud が正しいブラウザウィンドウを特定できるよう、これらの値のうち少なくとも 1 つを指定する必要があります。同じ、または非常によく似た識別子を持つブラウザウィンドウが複数ある場合は、テストケースでこれらの値を複数指定してください。

What's next

Check out the browser parameters that let you specify the browser you use with your test cases.