リモートブラウザをテストする

Tosca Cloudでは、リモートマシンおよびクラウド環境でウェブアプリケーションをテストできます。リモートブラウザ上で実行するテストケースを作成したり、開始から終了までリモートで実行されるプレイリストを作成したり、リモートテストとローカルテストを切り替えたりできます。

リモートマシンでテストを実行する

リモートマシン上のブラウザをテストするには、Webアプリケーションのコントロール機能を制御するテストケースを設計する必要があります。テストするWebサイトを開くには、OpenUrlモジュールを使用する必要があります。また、テストの終了時にブラウザまたはタブを閉じるには、CloseBrowserモジュールを使用することを推奨します。

リモートで操縦できるコントロール機能には、以下のようにいくつか例外があります。

マウスのMoveMethods。
オフセットパラメータのOffsetHorizontalとOffsetVerticalは、クリック操作「CLICK」でのみ機能します。
ドラッグ＆ドロップ操作。
キーボード入力シミュレーション「KeyDown」と「KeyUp」は、SHIFTキー、ALTキー、CONTROLキーのみに対応します。他のすべてのキーボードコマンドでは、SendKeysを使用します。
Safariではキーボードコマンドはサポートされていません。
ローカルマシン上で操作を実行する標準モジュール。

テストケースまたはプレイリストのテストケースパラメータも設定してください。リモートマシンで使用する技術に応じて、異なるパラメータ構成が必要になります。

BrowserStackでテストケースを実行する

BrowserStackでテストケースを実行するには、以下のテストケースパラメータを設定してください。

パラメータ	値	オプション
HubAddress	BrowserStack	いいえ
ブラウザ	このテストケースで使用するブラウザ。デフォルト値はChromeです。使用可能な値：InternetExplorer、Firefox、Chrome、Edge。	いいえ
BrowserVersion	ブラウザのバージョン。	はい
OperatingSystem	テストケースの実行に使用するオペレーティングシステム。	はい
WebDriverJson_<provideroptionstag></provideroptionstag>	使用するクラウドプロバイダー固有の機能を指定します。名前の構文： <ProviderOptionsTag>をクラウドプロバイダーのオプションタグに置き換えます。機能名の中のすべてのピリオドを2つのアンダースコアに置き換えます。機能名の中のすべてのコロンを3つのアンダースコアに置き換えます。例：BrowserStackのbstack:optionsタグの場合は、WebDriverJson_bstack___optionsです。このパラメータの値は、複数の機能を含めることができる、以下の構文を使用したJSON文字列でなければなりません。中括弧は、文字列の開閉に使用。セミコロンは、機能固有の値を定義するために使用。コンマは、機能を区切るために使用。二重引用符は、特殊文字をエスケープするために使用。他の仕様に使用する値の表現。例："{""userName"": ""<UserName>"", ""accessKey"": ""<accessKey>"", ""browserVersion"": ""136"", os"": ""OS X"", ""osVersion"": ""Monterey"", ""acceptInsecureCerts"": true, ""timeouts"": {""implicit"": 10000, ""pageLoad"": 30000}}" オプションタグ、機能名、機能固有の値については、お使いのクラウドプロバイダーのドキュメントを確認してください。	はい
BrowserStack_<capabilityname></capabilityname>	使用するBrowserStackの機能を指定します。名前の構文： <CapabilityName>をBrowserStackの機能に置き換えます。機能名の中のすべてのピリオドを2つのアンダースコアに置き換えます。機能名の中のすべてのコロンを3つのアンダースコアに置き換えます。例：Example.name:1の機能の場合は、BrowserStack_Example__name___1です。 BrowserStackの機能とその値については、BrowserStackのドキュメントを確認してください（新しいタブで開きます）。	はい

BrowserStackの機能を定義するために、テストケースのパラメータWebDriverJson_<ProviderOptionsTag>またはBrowserstack_<CapabilityName>を使用することができます。Browserstack_<CapabilityName>よりもはるかに多用途であるため、WebDriverJson_<ProviderOptionsTag>を使用することを推奨します。

WebDriver経由でテストケースを実行する

WebDriver経由でテストケースを実行するには、以下のテストケースパラメータを設定してください。

パラメータ	値	オプション
HubAddress	テストケースを実行するグリッドハブのIPアドレス。例：localhost（ローカルマシンでテストを実行するため）、http://<hubaddress>/wd/hub（リモートハブ用）。 Open the URL http://<IP:portnumber>/grid/console to check out information on the connection nodes.	いいえ
ブラウザ	このテストケースで使用するブラウザ。使用可能な値：InternetExplorer、Firefox、Chrome、Edge	いいえ
BrowserVersion	ブラウザのバージョン	はい
OperatingSystem	テストケースを実行するオペレーティングシステム	はい
WebDriverHubProxyAddress	テストケースを実行するプロキシサーバのIPアドレス。 WebDriverProxyUsernameおよびWebDriverProxyPasswordと一緒に使用します。	はい
WebDriverProxyUsername	プロキシサーバでの認証に使用するユーザー名。 WebDriverHubProxyAddressおよびWebDriverProxyPasswordと一緒に使用します。	はい
WebDriverProxyPassword	プロキシサーバでの認証に使用するパスワード。 WebDriverProxyUsernameおよびWebDriverHubProxyAddressと一緒に使用します。	はい
Fibermode	値を「TRUE」に設定すると、テストランの時間が改善されます。	はい
WebDriverUserProfilePreference_<preferencename></preferencename>	Chrome、Edge、FirefoxのWebDriverリモートテストにブラウザ固有のユーザープロファイル設定を適用します。名前の構文： <PreferenceName>をブラウザの設定に置き換えます。機能名の中のすべてのピリオドを2つのアンダースコアに置き換えます。機能名の中のすべてのコロンを3つのアンダースコアに置き換えます。例：設定Preference.name:1の場合は、WebDriverUserProfilePreference_Preference__name___1です。設定とその値については、お使いのウェブブラウザのドキュメントを確認してください。	はい
WebDriver_<capabilityname></capabilityname>	使用するWebDriverの機能を指定します。名前の構文： <CapabilityName>をWebDriverの機能に置き換えます。機能名の中のすべてのピリオドを2つのアンダースコアに置き換えます。機能名の中のすべてのコロンを3つのアンダースコアに置き換えます。例：Example.name:1の機能の場合は、WebDriver_Example__name___1です。 WebDriverの機能とその値については、WebDriverのドキュメント（新しいタブで開きます）またはBrowserStackのドキュメント（新しいタブで開きます）を確認してください。	はい
WebDriverJson_<provideroptionstag></provideroptionstag>	使用するクラウドプロバイダー固有の機能を指定します。名前の構文： <ProviderOptionsTag>をクラウドプロバイダーのオプションタグに置き換えます。機能名の中のすべてのピリオドを2つのアンダースコアに置き換えます。機能名の中のすべてのコロンを3つのアンダースコアに置き換えます。例：BrowserStackのbstack:optionsタグの場合は、WebDriverJson_bstack___optionsです。このパラメータの値は、複数の機能を含めることができる、以下の構文を使用したJSON文字列でなければなりません。中括弧は、文字列の開閉に使用。セミコロンは、機能固有の値を定義するために使用。コンマは、機能を区切るために使用。二重引用符は、特殊文字をエスケープするために使用。他の仕様に使用する値の表現。例："{""userName"": ""<UserName>"", ""accessKey"": ""<accessKey>"", ""browserVersion"": ""136"", os"": ""OS X"", ""osVersion"": ""Monterey"", ""acceptInsecureCerts"": true, ""timeouts"": {""implicit"": 10000, ""pageLoad"": 30000}}" オプションタグ、機能名、機能固有の値については、お使いのクラウドプロバイダーのドキュメントを確認してください。	はい

WebDriverの機能を定義するために、テストケースパラメータのWebDriverJson_<ProviderOptionsTag>またはWebDriver_<CapabilityName>を使用することができます。WebDriver_<CapabilityName>よりもはるかに多用途であるため、パラメータWebDriverJson_<ProviderOptionsTag>を使用することを推奨します。

ヘッドレスブラウザでリモートテストを実行する

WebDriver経由でChrome、Chromium、Firefoxのヘッドレスブラウザインスタンスでテストケースを実行することができます。新しいブラウザインスタンスや既に実行中のインスタンスでテストを実行する場合は、手順が異なります。

Chrome、Chromium、Firefoxの新しいヘッドレスブラウザインスタンスでテストを実行する

Chrome、Chromium、Firefoxの新しいヘッドレスブラウザインスタンスで実行するには、以下の手順に従ってください。

WebDriver経由でテストを設定します。
OpenUrlモジュールを使用してWebサイトを開きます。BrowserArguments > Argumentモジュールパラメータに、以下を指定してください。
- 「--headless」のようなヘッドレスモードでブラウザを起動する引数。
- 「--window-size=1024x640」のように適切なウィンドウサイズを指定する引数。

すでに起動しているChromeヘッドレスブラウザインスタンスでテストを実行する

すでに起動しているChromeヘッドレスブラウザインスタンスで実行するには、以下の手順に従ってください。

WebDriver経由でテストを設定します。
モジュール「Chrome/Chromiumアプリケーションに接続」を使用して、すでに実行中のChromeヘッドレスブラウザインスタンスに接続します。デバッグポートモジュールパラメータに、アプリケーションが実行されるデバッグポートを指定します。

すでに実行中のFirefoxヘッドレスブラウザインスタンスでは、テストを実行することはできません。