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.

In this topic:

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.

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 page. In the text box, start typing browser, version, or location.

• Filter. To focus on what is important to you, use the filter 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.

   • UFT Digital Lab version 24.2 and ValueEdge Digital Lab: You can copy text from a remote browser and also paste text to a remote browser. To paste text, click the Send text button , and paste the copied text.

4. To end the session, click the X button in the top 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.

   UFT Digital Lab version 24.2 and ValueEdge Digital Lab: To close the display without ending a manual testing session, click the Close display button .

Multiple remote sessions are supported. However, if you open a browser remotely that is already open, the browser will open in read-only mode. In read-only mode, the close button X closes the display but does not terminate a manual testing session.

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, and user (visible for admin users only). UFT Digital Lab version 24.2 and ValueEdge Digital Lab: Session type (manual testing, UFT One, or Selenium) is also displayed.

Find a specific session in one of the following ways:

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

• Filter. To focus on what is important to you, use the filter to limit the items that are displayed. Using the filter panel, you can specify Browser, Version, location.
  UFT Digital Lab version 24.2 and ValueEdge Digital Lab: You can also filter by session type: manual testing, UFT One, or Selenium.

Admin users can view, or Stop and remove , all browser sessions or a selected browser session. Workspace admins and regular users can view, 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 the browser is already open, 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 filter panel, select the core browser capabilities required.

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

   The code is generated 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 tables:

Browser capabilities	Description
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 browser capabilities -dl options	Description
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