Applies to TestComplete 14.50, last modified on August 05, 2020
This topic describes how you can connect to the service by using the CrossBrowserTesting manager and run tests in Windows-based environments in web browsers that TestComplete supports (Edge, Internet Explorer, Chrome, and Firefox). This method of integrating with is deprecated starting with TestComplete 14.40. We recommend using the Device Cloud add-on instead. See About Cross-Platform Web Tests for details. is a cloud service that provides environments for functional web testing (see TestComplete integrates with the CrossBrowserTesting cloud and enables you to run automated web tests with ease there. This topic provides information on integration features.

Why Integrating With

In TestComplete, you can connect to the CrossBrowserTesting cloud and run your web tests in CrossBrowserTesting environments. This way, you will be able to —

  • Verify your web application behavior in various web browsers running on various operating systems and screen resolutions.

  • Perform the checks without purchasing and configuring additional software and hardware.

  • Easily configure parallel test runs directly from TestComplete. Since the tests run in parallel, you can significantly decrease the test execution time.

  • Get accumulated test results on one computer (on your machine, from which you run tests).

If you already use the CrossBrowserTesting cloud for functional web testing, you can use TestComplete to automate your test runs.

About CrossBrowserTesting in TestComplete

To integrate with CrossBrowserTesting, you use the CrossBrowserTesting manager. You use it to connect to CrossBrowserTesting, manage environments, assign tests to them and run the tests.

To add the manager to your project suite node in the Project Explorer, right-click your project suite and then click Add > CrossBrowserTesting.

To open the manager, double-click the CrossBrowserTesting item in the Project Explorer:

TestComplete integration with CrossBrowserTesting: CrossBrowserTesting Manager

Click the image to enlarge it.

In the Tests section of the manager, you can view, create, and manage tests and test items to be run in the CrossBrowserTesting cloud. To each test, test item, or a group of tests and test items, you can assign environments in which they will run. You can see the environments in the Environments section on the right. An environment is a combination of a web browser, operating system and screen resolution for the run.

TestComplete can run tests only in environments that are running under the supported Windows versions and use the supported versions of web browsers.

You can view the available combinations of web browsers and operating systems on our web site:

Note: If you try to select a non-supported combination of a web browser and operating system, TestComplete will replace the selected browser or operating system with the proper one.

A test or a test item will run in every environment assigned to it.

See CrossBrowserTesting - Common Tasks for information on working with the manager.


To work with

Getting Started With CrossBrowserTesting

Add the CrossBrowserTesting manager to your project suite. To do this, right-click your project suite node in the Project Explorer and then click Add > CrossBrowserTesting.

When the manager is added, it will show the Get Started form that provides basic information on the CrossBrowserTesting cloud:

TestComplete integration with CrossBrowserTesting: Getting Started

Click the image to enlarge it.

View the video to learn about TestComplete integration with CrossBrowserTesting.

Note: To view the video, your computer must be connected to the Internet.

To open the form again, click About on the manager toolbar.

In addition, TestComplete will show instructions that will guide you through running tests in CrossBrowserTesting environments:

TestComplete integration with CrossBrowserTesting: Step-by-step instructions

Click the image to enlarge it.

Follow the instructions to run a test in the CrossBrowserTesting cloud.

TestComplete will show the instructions until you run a test in a CrossBrowserTesting environment. To command TestComplete to show the instructions again, click About on the manager toolbar, and then click Get Started in the resulting form.

How the Integration Works

When you command TestComplete to run tests in the CrossBrowserTesting cloud, TestComplete –

  1. Connects to the cloud. You will need a CrossBrowserTesting account for this. If you do not have one, TestComplete will suggest creating a trial account.

    TestComplete associates the CrossBrowserTesting credentials with your Windows account and stores them outside the project suite files. If you run TestComplete under another Windows account, or if you run tests on another machine, you will need to specify the CrossBrowserTesting account again.
  2. Commands the CrossBrowserTesting service to launch all the needed environments.

    CrossBrowserTesting will select the environments that have been prepared for running TestComplete tests. These environments have TestExecute installed.

    For each test assigned to environments, it will launch a separate set of environments.

  3. Copies your project suite with all its contents to the environments. If your project suite includes external project items (for example, tests that belong to another project suite) or external third-party files, TestComplete will copy them, as well.

    Note: Your test projects must not refer to external items residing on other drives or in a network location. Such items will not be available in CrossBrowserTesting environments.
  4. Copies all the registered script extensions to the environments. If your tests use functionality provided by a script extension, they will run successfully. You can find a list of registered script extensions in the File > Install Script Extensions dialog. (After the test run is over, the script extension files will be removed from the environments.)

  5. Runs the tests in the CrossBrowserTesting cloud concurrently. Each test runs in a separate environment.

    TestComplete runs only those tests that are enabled (checked) in the manager. If a test is unchecked (disabled), TestComplete does not run it. If a group is unchecked, TestComplete does not run any tests or test items that belong to that group. If an environment is unchecked, TestComplete does not run tests in that environment.

    While the tests are running, you can view the test status in the manager. For example, the Waiting status indicates the test engine is waiting for the test machine to start in the cloud, and Running means the test is working:

    TestComplete integration with CrossBrowserTesting: Running tests in CrossBrowserTesting environments

    Click the image to enlarge it.

    A video of your tests is recorded during the test run. After the test run is over, you can view the video from the test log.

    Note: Recorded videos are limited to 10 minutes. If your test runs longer, you will be able to view only the first 10 minutes of the test run.
  6. Gets the test results of each test in each environment after the test run is over.

  7. Terminates the environments.

Viewing Test Results

After the test run is over, TestComplete copies the test results from the CrossBrowserTesting cloud to your computer. You can see them in a special log panel in TestComplete logs. This panel contains information on the browser, operating system and screen resolution that were used for the run and links to the videos the CrossBrowserTesting cloud recorded. See Viewing Test Results (CrossBrowserTesting Logs) for details.

Creating and Running Tests

For a step-by-step description of how to create groups, add tests to them, and set environments for a run, follow this link –

Running Tests in CrossBrowserTesting Environments

Important Notes

  • You can initiate test runs in CrossBrowserTesting environments only from TestComplete. TestExecute does not support running tests in CrossBrowserTesting environments.

  • The number of concurrent tests you can run in CrossBrowserTesting environments is specified by your CrossBrowserTesting subscription plan. If the number of tests you are going to run exceeds the maximum number, TestComplete will run the exceeding tests after the earlier tests are finished. If you use the same CrossBrowserTesting account to run tests in several TestComplete instances working on different computers, then the number of available concurrent tests is shared among all these computers.

    You can view the number of concurrent tests you can run on the Account Details form in TestComplete. If you are logged in, click Account Details on the CrossBrowserTesting toolbar and TestComplete will show information on your account.

    Find more information on CrossBrowserTesting subscriptions on the CrossBrowserTesting web site.

  • The CrossBrowserTesting credentials you specify are stored apart of the project suite file. TestComplete associates them with your Windows account. If you run TestComplete under another user account, or if you open your project suite on another computer, you will need to specify the CrossBrowserTesting credentials again.

  • CrossBrowserTesting exists and operates on the project-suite level. This means you can configure and run tests of all the projects that belong to your project suite.

    If you store your tests in a source control system, make sure to include the project suite files and the CrossBrowserTesting files in the repository. They reside on an upper level in comparison with project files.

  • See also important notes on running tests in the CrossBrowserTesting cloud.

See Also

Integration With
Working With TestComplete

Highlight search results