Known issues - Web Add-in

This topic contains general troubleshooting and limitation information about working with the Web Add-in.

Note: Some folder paths intentionally include previous company branding, due to backward compatibility considerations.


  • UFT One web agents on different pages and frames use window.postMessage to communicate with each other. If the application you are testing listens to MessageEvent, and handles messages from the UFT One web agent, unpredictable behavior may occur.

    It is generally recommended that web applications be designed to ignore messages from sources other than itself. For details, see

  • Regular expressions are not supported for numeric properties of Web test objects, such as WebButton.

  • When using dynamic add-in loading, UFT One identifies objects differently when you open the browser before or after you open the test.

    Therefore, if you did not select the Web add-in when opening UFT One, make sure that you open the browser and test in the same order when learning the objects (spy/record) and when running the test.

Back to top

Object identification

AI-based testing

When your browser scope is WebPage (the default), the drop-down items of a combo box are not properly visible to AI. As a result, the drop-down items are either not identified by AI, or are identified in the wrong location.

Workaround: Change the browser scope mode to BrowserWindow using the step:

AIUTil.Context.SetBrowserScope BrowserWindow

Using the Web and Siebel Add-ins together

If you open UFT One with the Siebel Add-in loaded, the Web Add-in does not appear in the Object Identification dialog box.


Change the value of the HKEY_CURRENT_USER\Software\Mercury Interactive\QuickTest Professional\MicTest\Packages\SiebelPackage\Settings\AllowWebToConfig registry key value to 1.

Empty values returned

If your application objects do not implement the aria-selected attribute in the application's controls, certain description properties return empty values.

Affected properties include: selected, items count, selected items, selection, and value return empty values.

Dynamically generated child WebTree objects

If the child items in a WebTree object are generated dynamically, UFT One may not be able to select the items in the tree automatically using the .Select method. 

Specifically, this may occur when the child objects are not visible or present in the application until the parent node is expanded.

Workaround: Manually add steps to make the nodes visible or expand tree nodes to create the object in the application.

Bootstrap libraries

Objects in a BootStrap library that use the <a> element with both the btn and disabled classes cannot be recognized by UFT One.

These classes disable pointer-events, which are required for UFT One object recognition.

Back to top

Browser zooming and Windows display scaling (DPI)

In some cases, for UFT One to identify and highlight objects in the correct location, you must learn the objects and run the tests at 100% browser zoom level and Windows display scaling level.

In these cases Set browser zoom level to 100% Set Windows display scaling level to 100%
Working with Internet Explorer or IE mode in Edge
Working with Chromium Embedded Frameworks

Using the OpenText UFT Agent Chrome extension version 2022 available online or installed from the v3 folder.

(How can I tell if I am using the relevant extension: Navigate to the chrome://extensions/ page and click Details on the OpenText UFT Agent extension. The Inspect views of the extension are service worker.)

Working on a Virtual Machine that is connected not by using Remote Desktop Connection

Back to top


Autocomplete during recording sessions

Autocomplete is not supported during recording sessions. When recording on an autocomplete control, enter the full string instead of selecting the suggestion provided by the control. The step is recorded in the same way as other (non-autocomplete) controls.

Workaround: You can disable the AutoComplete feature in Microsoft Internet Explorer by selecting Tools > Internet Options > Advanced and deselecting the Use inline AutoComplete under the Browsing options.

Recording WebTree objects with child objects

If a WebTree object contains separate objects inside the tree (such as a checkbox object), these child objects are not recorded.

Workaround: Do one of the following:

Spy on the child object
  1. Spy on the child object to get the relative Xpath value of the tree item.
  2. Then, add a WebTree.Select method, with the Xpath value you retrieved from the spy for the XPath argument of the .Select method.
Add the object manually

Add the object into the object repository and manually add it to the test or component.

Recording objects embedded in Web tables

If you are recording actions on objects embedded in a Web table, these actions may not be recorded properly. Readjust your test after recording as necessary.

Back to top

Running on cloud browsers

You can run tests on cloud browsers provided by Digital Lab and view the application as the test runs. However, you cannot spy on applications or record steps. For details, see Test Web apps on cloud browsers.

Additional unsupported features

The following features are not supported when running tests on Digital Lab cloud browsers: 

  • Business Process Testing

  • AI objects

  • Insight objects

  • Environment variables

  • Headless browsers

  • UFT One automation scripts (automating UFT One).

Known issues

The following known issues are relevant when running web tests on Digital Lab cloud browsers: 

Mouse replay types

Running tests on cloud browsers using the Mouse replay type is not supported.

Make sure that Event is selected as the Replay type in the Run settings section of the Web > Advanced options pane (Tools > Options > GUI Testing tab > Web pane > Advanced node).

Running from Jenkins
  • When running from a Jenkins pipeline, browser parameters cannot be changed from the pipeline itself. Change the configuration directly in the UFT One script.

  • Jenkins Application Automation Tools plug-in versions 23.3 and 23.4: To run tests on cloud browsers, configure the connection to Digital Lab in the Record and Run Settings dialog box, and leave the Digital Lab connection settings empty in Jenkins.

Rerunning a test on a cloud browser

When you run a test on a local browser and re-run it on a cloud browser, UFT One closes the launched local browser tab before running the test on the cloud browser. This occurs when Close the browser when the test closes is selected on the Web tab of the Record and Run Settings dialog.

Run on secure websites only

Digital Lab cloud browsers support only https websites.

Note: If you are working with Digital Lab version 23.4 and Edge or Firefox cloud browsers you need to include the https in the URL.

Back to top


Bitmap and page checkpoints created on one browser may fail when running on another browser, because different browsers visually render web objects differently.

For page checkpoints this is related to differences in the handling of casing in HTML source files.

Back to top

WebAgGrid test objects

Related Add-ins

Starting from UFT One 15.0, WebAgGrid objects are supported by the AgGrid Web child Add-in, which is not loaded by default. If you want to test AgGrid objects, make sure to open UFT One with the AgGrid Add-in selected in addition to the Web Add-in.

To open or run tests that were created in earlier UFT One versions and use AgGrid objects, associate the AgGrid Add-in with the tests in the Properties pane of their Test Settings.

  • Checkpoints on WebAgGrid test objects only validate table content that is available in the DOM.

  • Checkpoints may fail because of the UFT is debugging banner displayed in Chrome while running a test. Close this banner and re-run your test.

    To close the banner, do one of the following:

    • Close the banner manually when running the test.
    • Enable silent debugging in Chrome settings.
  • Operations of collapsed rows or columns may behave unexpectedly. To avoid errors, ensure the row or column is expanded before running your test.
  • Operations on a row or a column with a large number may behave unexpectedly.



If a WebAgGrid object is sorted by column, the column cannot be identified by the GetCellData method.

Note: GetCellData steps fail only for the sorted column. All other columns are identified successfully.

Workaround: Remove sorting on the column and run your test again.

Specifying a property to use for an object's logical name

Logical name definition is not supported for WebAgGrid and WebUIGrid test objects.

For more details, see the WebAgGrid object in the UFT Object Model Reference.

Back to top

WebUIGrid test objects

  • Starting from UFT One 15.0, WebUIGrid objects are supported by the UIGrid Web child Add-in, which is not loaded by default. If you want to test UIGrid objects, make sure to open UFT One with the UIGrid Add-in selected in addition to the Web Add-in.

    To open or run tests that were created in earlier UFT One versions and use UIGrid objects, associate the UIGrid Add-in with the tests in the Properties pane of their Test Settings.

  • Checkpoints on WebUIGrid test objects only validate table content that is available in the DOM.

  • Logical name definition is not supported for WebAgGrid and WebUIGrid test objects.

Back to top

See also: