Enable the Micro Focus UFT Agent extension on Google Chrome

UFT One communicates with the Micro Focus 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 Micro Focus UFT Agent extension. When you complete the set up, make sure you have only the latest extension installed.

Browser extension versions

Chrome versions 95 and later support working with Manifest V3 extensions, which will eventually be the mandatory type of extensions when working with Chrome.

The Micro Focus UFT Agent Manifest V3 extensions are available online and in the UFT One installation folder: <UFT One installation folder>\Installations\Chrome\v3.

The Manifest V2 extensions are available as well, for use on older browser versions or for troubleshooting: <UFT One installation folder>\Installations\Chrome\v2

Back to top

Prerequisite

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

Back to top

Automatic Chrome updates enabled

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 Micro Focus 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 Micro Focus 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

Automatic Chrome updates disabled

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 Micro Focus UFT Agent extension from the Chrome web store.

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

The Agent for Google Chrome is not available via search of the Chrome web store.

Chrome version 95 and later 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 installation folder>\Installations\Chrome\v3 folder into Chrome's Extensions page.

If dragging the extension to Chrome does not work, do the following: 

  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 Micro Focus 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 installation folder>\Installations\Chrome\v2

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 disabled in Google Chrome. Do the following 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 Micro Focus 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

Browser extension versions

Chrome versions 95 and later support working with Manifest V3 extensions, which will eventually be the mandatory type of extensions when working with Chrome.

UFT One 2021 R1 Patch 1 provides a Manifest V3 extension.

The Manifest V3 extension is available online and in the UFT One installation folder: <UFT One installation folder>\Installations\Chrome\v3.

The earlier, Manifest V2, extension is available in the <UFT One installation folder>\Installations\Chrome\ folder.

In UFT One 2021 R1 Patch 1 you can use this extension for older browser versions or for troubleshooting.

Back to top

Prerequisite

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

Back to top

Automatic Chrome updates enabled

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 Micro Focus UFT Agent Chrome extension 2021.1 is automatically downloaded and installed the first time you open Chrome after installing UFT One.

Inactive Internet connection

Without an Internet connection, Chrome attempts to download and install the Micro Focus UFT Agent Chrome extension 2021.1 each time you open Chrome.

After downloading, Chrome prompts you to activate the extension.

Back to top

Automatic Chrome updates disabled

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

Chrome version 68 or later Active Internet connection

Install and enable the Micro Focus UFT Agent Chrome extension 2021.1 in the Chrome web store.

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

The Agent for Google Chrome is not available via search of the Chrome web store.

Inactive Internet connection

Install manually as described in Google Chrome versions 68 and later without Internet.

Chrome version 67 or earlier

Google Chrome versions 67 and earlier

Back to top

Google Chrome versions 68 and later without Internet

Install the extension manually as follows:

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

  2. Drag the Agent.crx file from the relevant folder into Chrome's Extensions page:

    • UFT One 2021 R1 Patch 1, using Chrome 95 and later: 

      <UFT One installation folder>\Installations\Chrome\v3

    • UFT One 2021 and 2021 R1, or when using Chrome 94 and earlier:

      <UFT One installation folder>\Installations\Chrome

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 and select the relevant folder: 

    • UFT One 2021 R1 Patch 1, using Chrome 95 and later: 

      <UFT One installation folder>\Installations\Chrome\v3\Extension

    • UFT One 2021 and 2021 R1 or when using Chrome 94 and earlier:

      <UFT One installation folder>\Installations\Chrome\Extension

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

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

Back to top

Google Chrome versions 67 and earlier

  1. If you have a previous version of the UFT One Agent for Google Chrome installed, manually remove this extension.

  2. Open the Chrome folder included with the UFT One installation: <UFT One installation folder>\Installations\Chrome.

  3. Select Tools > Extensions in Google Chrome.

    Note: You can also access this page by opening the chrome://extensions page in Google Chrome. The Extensions page opens.

  4. From the <UFT One installation folder>\Installations\Chrome folder, drag the AgentLegacy.crx file to the chrome://extension page.

  5. In the Confirm New Extension dialog, click Add to install the extension.

    The Micro Focus UFT Agent for Google Chrome is now displayed in the Chrome extensions list.

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 disabled in Google Chrome. Do the following 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 Micro Focus 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: