Run Remote Browser Operation

Description

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.

Requirements

• TestComplete 14.4.

• An active license for the TestComplete Web Module and for the Device Cloud add-on.

  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.

• 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.

Operation Result

The operation does not return any value.

Scripting Analogue

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.

Child Operations

The operation cannot have child operations.

Operation Parameters

When you add the operation to your keyword test, TestComplete displays a wizard that contains the following pages.

Sign In to Your Account

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:

Parameters

Custom Parameters

Using an existing account - Show instructions

Using an existing account - Show instructionsUsing an existing account - Show instructions

To specify your active CrossBrowserTesting account:

1. Add the operation to your keyword test.

2. If TestComplete fails to find an active CrossBrowserTesting account, it will show the Sign In to Your Account form.

3. 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 the image to enlarge it.

   Click Sign In.

TestComplete will validate the account data.

Creating a free trial account - Show instructions

Creating a free trial account - Show instructionsCreating a free trial account - Show instructions

If you do not have a CrossBrowserTesting account, you can sign up for a free trial directly from TestComplete:

1. Add the operation to your keyword test.

2. If TestComplete fails to find an active CrossBrowserTesting account, it will show the Sign In to Your Account form. Click Try for free.

3. Enter your email address and the password you will use to connect to the CrossBrowserTesting:

   

   Click the image to enlarge it.

4. 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.

To learn about CrossBrowserTesting terms of use, see Terms of Service and Privacy Policy.

Run Remote Browser

On this page, you can specify the following:

Parameters

• 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.

  Important notes:

  • 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:

    help.crossbrowsertesting.com/local-connection/general/local-tunnel-overview/

• Platform - You can select one of the following platform types:

  • Desktop

  • Mobile

  • Headless

• 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.

Custom Parameters

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:

JSON

JSON

{
  "name": "My test",
  "record_video": "true"
}

The JSON code will be validated as you are typing it.

See the list of available capabilities on the CrossBrowserTesting.com website:

help.crossbrowsertesting.com/selenium-testing/getting-started/crossbrowsertesting-automation-capabilities/

Operation Parameters

On this page, you can specify the following parameters:

Server URL

Specifies the URL of the Selenium Grid provided by CrossBrowserTesting.com. It can be one of the following:

• http://hub.crossbrowsertesting.com:80/wd/hub

• http://hub-cloud.crossbrowsertesting.com:443/wd/hub

Tested URL

Specifies the URL of the tested web page that the specified web browser on the remote platform will open upon launching.

Capabilities

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.

See Also

Web Category
CrossBrowserTesting.com
About Cross-Platform Web Tests
Run Browser Operation