Enable the OpenText UFT Agent extension on Google Chrome

UFT One communicates with the OpenText UFT Agent Chrome Extension to test Web applications running in Google Chrome. This topic describes how to install and enable the extension in your Chrome browser.

Note: If you have the Functional Testing Agent for Google Chrome installed, you may need to manually remove this extension before enabling its new version, the OpenText UFT Agent extension. When you complete the set up, make sure you have only the latest extension installed.

Prerequisite

Your browser policy must allow you to install browser extensions. Otherwise, see Enable extension installation in your browser policy.

Back to top

Automatic extension installation

If you have automatic Chrome updates enabled, the extension installation depends on whether you have an Internet connection.

Active Internet connection

If you're connected to the Internet, the OpenText UFT Agent Chrome extension is automatically downloaded from Chrome web store and installed the first time you open Chrome after installing UFT One.
Inactive Internet connection

Without an Internet connection, Chrome attempts to download the OpenText UFT Agent Chrome extension from Chrome web store and install it each time you open Chrome.

After downloading, Chrome prompts you to enable the extension.

Back to top

Manually install the extension

If you do not have automatic Chrome updates enabled, install the extension as follows:

Chrome version 95 and later

Active Internet connection

Install and enable the OpenText UFT Agent extension from the Chrome web store.

UFT One 24.2: 

Install from the OpenText UFT Agent 24.2 page.

UFT One 23.4:

Install from the OpenText UFT Agent 2023-23.4 page.

Note: Before installing, make sure the extension version matches your UFT One version.

The Agent for Google Chrome is not available using search on the Chrome web store.
Inactive Internet connection

Install the extension manually from the UFT One installation folder.

  1. Select Tools > Extensions in Google Chrome to open the chrome://extensions page.

  2. Drag the Agent.crx file from the <UFT_One_installdir\Installations\Chrome\v3 folder into Chrome's Extensions page.

If dragging the extension to Chrome does not work: 

  1. Select Tools > Extensions in Google Chrome to open the chrome://extensions page.

  2. In the Extensions page, select the Developer mode option. Additional options are displayed after you select this option.

  3. Click on the Load unpacked button.

  4. In the Browse for Folder dialog, browse to the <UFT One installation folder>\Installations\Chrome\v3\Extension folder.

  5. In the Confirm New Extension dialog, click Add when prompted.

    The OpenText UFT Agent is now displayed in the Chrome extensions list.

Enable the extension in Chrome.

Chrome version 94 and earlier

Install the extension manually from the UFT One installation folder.

Follow the instructions for Inactive Internet connection, but use the extension from this folder: 

<UFT_One_installdir>\Installations\Chrome\v2

Back to top

Automatically load the extension temporarily on Chrome

Supported on UFT One 24.2 and later

If you cannot install the Chrome browser extension from the web store, you can configure UFT One to load the extension when recording or running your tests.

A OpenText UFT Agent extension is included in the UFT One installation. When a Chrome browser is opened by a record or run session, the unpacked extension can be automatically loaded on the browser. The extension remains only on that browser instance, and only until it closes.

Note:  

  • For the extension to be successfully loaded on the browser opened by the record and run session, make sure no instance of the browser is open before you start the session.

  • If the OpenText UFT Agent extension is already installed on your browser, but not enabled, the automatic loading does not enable the extension. For web tests to run correctly, make sure the installed extension is enabled.

You can configure this in the Options dialog box (Tools > Options > GUI Testing > Web > Advanced > Load the OpenText UFT Agent browser extension on Chrome) or using the Automation Object Model (AOM).

See the WebOptions object in the UFT One Automation Object Model Reference.

Back to top

Enable UFT One to test applications with strict Content Security Policies (CSPs)

To test a web application, UFT One must communicate with the application, including JavaScript injection. In some cases, applications block this ability. For details, see Testing applications with strict Content Security Policies (CSPs).

Back to top

Enable UFT One to test local HTML pages in Google Chrome

By default, the ability to run extensions on local HTML files is deactivated in Google Chrome.

To allow the UFT One Google Chrome extension to run on local HTML files:

  1. In Google Chrome, browse to the following URL: chrome://extensions

  2. Locate the OpenText UFT Agent for Google Chrome.

  3. Click the arrow located to the left of the icon to expand details about the extension.

    Select Allow access to file URLs. Your selection is automatically saved.

Back to top

See also: