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.

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.

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

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

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

If you are using the most recent version of UFT One
  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 folder into Chrome's Extensions page.

If you see an error, continue with If you are using a previous version of UFT One, or if dragging the extension to Chrome did not work.

If you are using a previous version of UFT One, or if dragging the extension to Chrome did 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 <UFT One installation folder>\Installations\Chrome\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.

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, found at <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: