You use the Run Remote Browser operation in cross-platform web tests. It allows connecting to your CrossBrowserTesting.com account (if you are not connected yet), selecting a platform, a web browser, and a web page to run. All operations that interact with the current browser and that follow the Run Remote Browser operation will run in the specified web browser on the specified device at CrossBrowserTesting.com.
If you are running your cross-platform web tests by using TestExecute, you have to purchase the license for the Device Cloud add-on for TestExecute separately.
If you want to run several cross-platform web tests in parallel, you may be interested in the Device Cloud Parallel package. To learn more, please contact our Sales Team.
The Web Testing plugin must be enabled in TestComplete (it is installed and enabled by default).
The Device Cloud add-on must be installed and enabled in TestComplete (it is installed and enabled by default).
An active CrossBrowserTesting account.
Note: If you do not have an account, you can sign up for a free trial directly from TestComplete—TestComplete will suggest that you do this automatically if it does not find appropriate account data when you add the operation to your test.
The CrossBrowserTesting web site must be accessible from the computer where TestComplete is installed.
The operation does not return any value.
The operation is similar to specifying the desired capabilities of the target platform and running the remote web browser by using the
Browsers.RemoteItem.Run method from script tests.
The operation cannot have child operations.
When you add the operation to your keyword test, TestComplete displays a wizard that contains the following pages.
The wizard shows this page if your project does not have a CrossBrowserTesting.com account specified.
On this page, you can connect to your existing CrossBrowserTesting.com account or create a new trial account:
To specify your active CrossBrowserTesting account:
Add the operation to your keyword test.
If TestComplete fails to find an active CrossBrowserTesting account, it will show the Sign In to Your Account form.
Enter the email address and password you use to connect to CrossBrowserTesting (you can specify the email and password of your account or subaccount):
Click Sign In.
TestComplete will validate the account data.
If you do not have a CrossBrowserTesting account, you can sign up for a free trial directly from TestComplete:
Add the operation to your keyword test.
If TestComplete fails to find an active CrossBrowserTesting account, it will show the Sign In to Your Account form. Click Try for free.
Enter your email address and the password you will use to connect to the CrossBrowserTesting:
Click Start Trial.
Important: The email address you specify must be valid. You will have to confirm it. The password must not be blank and must contain at least 6 alphanumeric symbols. You can find complete information on password requirements on the CrossBrowserTesting web site.
CrossBrowserTesting accounts are time-limited. Also, they limit the number of concurrent test runs, the number of test minutes and the number of subaccounts. You can find information on your account on the Account Details form in TestComplete or on your account page of the CrossBrowserTesting web site.
On this page, you can specify the following:
Tested site URL - The URL of the tested web page that the specified remote browser will open upon launching. Typically, it should be the page from which your testing actions will start.
We recommend that you specify the complete URL of your target web page, including the protocol name. For example, http://services.smartbear.com/samples/TestComplete14/smartstore/. Otherwise, TestComplete will use the
HTTPS protocol to navigate to the target web page and post a warning to the test log.
If your tested web application is behind a firewall in your local network or on your local computer, you need to make it available to remote environments. To do this, you can use a local connection— an encrypted tunnel between your computer and the CrossBrowserTesting device cloud. The CrossBrowserTesting service will route all traffic to your tested web application through your computer.
To learn more about local tunnels and how to open them, see the CrossBrowserTesting documentation:
Platform - You can select one of the following platform types:
Device - Select one of the devices provided by CrossBrowserTesting.com.
Browser - Select a web browser in which you want to run your web test.
Resolution - Select the screen resolution that will be set on the target platform for the test run.
On this tabbed page of the operation, you can specify additional capabilities that will be used for your test run in the device cloud.
You specify additional capabilities in the JSON format. For example:
"name": "My test",
The JSON code will be validated as you are typing it.
See the list of available capabilities on the CrossBrowserTesting.com website:
On this page, you can specify the following parameters:
Specifies the URL of the Selenium Grid provided by CrossBrowserTesting.com. It can be one of the following:
Specifies the URL of the tested web page that the specified web browser on the remote platform will open upon launching.
Specifies the string that defines the desired capabilities of the remote environment where you want to run your test. To learn which capabilities are available, please see the documentation on available capabilities at the CrossBrowserTesting.com website help.crossbrowsertesting.com/selenium-testing/getting-started/crossbrowsertesting-automation-capabilities.