Browser lab

Run tests from UFT One, or run Selenium tests or manual tests on cloud desktop browsers in the Digital Lab Browser lab. In the Browsers tab, you can open a cloud browser for manual testing. In the Sessions tab, you can view and manage all running browser sessions. In the Selenium capabilities tab, you can use the script generator to generate the code required for running your Selenium v4 test with Digital Lab.

Before you start

The Browser Lab is displayed only if:

  • The cloud browser lab integration is enabled. For details, see the OpenText hosted lab integration in Administration settings.

  • You have a valid license.
    UFT Digital Lab: A valid public device and cloud browsers hours license must be installed on AutoPass server, and the AutoPass License server settings must be configured in the Digital Lab Administration settings.

You may also require an execution key to connect to the lab.

Note:  

  • UFT Digital Lab: In addition to key-based authentication, password authentication is also supported on UFT One.

  • ValueEdge Digital Lab:To run a test using Digital Lab, you need an execution key. The key is used to authenticate the connection to Digital Lab. For details, see Access key management.

  • Due to security restrictions, only HTTPS websites are supported on cloud browsers.

Back to top

Browsers tab

In Browser Lab > Browsers you can open a cloud browser for manual testing. Browser versions, as well as the location of the browser machines are displayed.

Find a specific browser machine in one of the following ways:

  • Search. Click the Search button at the top of the Browser Lab screen. In the text box, start typing browser, version, or location.

  • Filter. To focus on what is important to you, use the filter in the left panel to limit the items that are displayed. Using the filter panel, you can specify browser, version, and location.

Run an automated test on a cloud browser

You can run automated UFT One and Selenium tests on cloud browsers. The table below describes how to run an automated cloud browser test:

Test type How to run
UFT One After configuring the Digital Lab integration, use the Web tab in the Record and Run Settings to select a browser for your test. For details, see the UFT One Help Center.
Selenium Use the script generator in the Browser Lab > Selenium capabilities tab to generate the code required for your Selenium v4 tests.

Run a manual test on a cloud browser

You can interact with a cloud browser remotely to perform manual and exploratory testing.

To run a manual test:

  1. Hover over the browser in Card view.

  2. Click the Open browser remotely button .

  3. Optional: Click the Take screenshot button to take a screenshot of the cloud browser display.

  4. To end the session, click the X button in the top-right corner of the remote display.
    Note: If you close the browser tab, the session continues to run, even though the remote view is no longer visible.

Multiple remote sessions are supported. However, if you open a browser remotely and it has already been opened remotely by someone else, the browser will be in read-only mode. In read-only mode, the close button X closes the display but does not terminate the session.

Note: Other operations such as opening a command line, or installing or opening other browsers on the cloud machine are not recommended.

Back to top

Sessions tab

The Browser lab > Sessions tab, provides an overall view of current browser testing sessions. These can be UFT One, Selenium, or manual testing sessions. You can also manage sessions from this tab, or access a cloud browser remotely for debugging an automated test. UFT One browsers tests can also be opened directly from UFT One.

Running sessions are displayed with the following details: Browser, OS, Location, start time, duration, user (visible for admin users only). Find a specific session in one of the following ways:

  • Search. Click the Search button at the top of the Sessions screen. In the text box, start typing Browser, version, or location.

  • Filter. To focus on what is important to you, use the filter in the left panel to limit the items that are displayed. Using the filter panel, you can specify Browser, Version, and location.

Admin users can see, or Stop and remove , all browser sessions or a selected browser session. Workspace admins and regular users can see, or stop and remove, only sessions that they created.

Open a running session

To access a running browser session:

  1. Select the session in the grid.

  2. Click the Open cloud browser button at the top of the grid, to open the cloud browser remotely.

If you open a browser that has already been opened by someone else, the browser will open in read-only mode.

Back to top

Selenium capabilities tab

Use the script generator in the Browser Lab > Selenium capabilities tab to generate the code required for running Selenium v4 tests through Digital Lab. When the script is executed with the driver creation command, a cloud machine is allocated according to the selected capabilities and the test is run on it.

To generate the Selenium script: 

  1. In the left panel, select the core browser capabilities required.

  2. In the right panel, select your programming language.

    Digital Lab generates the code automatically. The code includes the Digital Lab server URL in the RemoteWebDriver, and the required capabilities based on your selections.

  3. Click Copy to clipboard.

  4. Paste the code into your Selenium v4 script.

  5. Edit the script to include your oauthClientId, oauthClientSecret, and tenantId. These details are available when you generate an execution key. For details, see Access key management.

Alternatively, you can manually add the capabilities and the Digital Lab server URL to your Selenium script.

The mandatory capabilities for Selenium are detailed in the following table:

Browser capabilities
browserType The browser on which you want to run your test: Firefox, Chrome, or Edge
browserVersion The version of the browser you want to test. Use latest to choose the latest release supported by Digital Lab. For details, see the Support matrix.
Digital Lab specific capabilities - prefix dl:options
oauthClientId An execution type access key that is needed to run tests with Digital Lab. For details, see Access key management. When you generate the key, you can copy the credentials to the clipboard.
oauthClientSecret The client secret is provided together with the client ID when you generate your execution access key.
tenantId The tenant ID is provided together with the client ID and secret when you generate your execution access key.  
osType The operating system of the cloud browser machine.
region The location of the cloud browser machine.

Back to top