Set up web browsers and controls

Set up your browsers to enable the relevant Functional Testing agent extension, so that LeanFT can identify objects in your browsers.

If you want to test a non-Web application that contains a browser control, you must also register the browser control.

Set up Google Chrome for LeanFT

The first time you launch Chrome after installing LeanFT, you are prompted to enable the HPE Functional Testing Agent extension. Click Enable.

If the extension was not automatically installed:

  1. In the Chrome menu, select More Tools > Extensions.

  2. Drag the agent.crx file from:

    Windows <LeanFT installation>\Installations\Chrome
    Linux / Mac <LeanFT installation>/Installations/Chrome

    to the Extensions page, and click Add.

  3. Make sure the HPE Functional Testing Agent extension is enabled.

Back to top

Set up Mozilla Firefox for LeanFT

The first time you launch Firefox after installing LeanFT, you are prompted to confirm the HPE Functional Testing Agent extension. Click Allow and then click Continue.

If the extension was not automatically installed:

  1. In the Firefox browser menu, select Add-ons and then click Extensions.

  2. Drag the Agent.xpi file from:

    Windows <LeanFT installation>\Installations\Firefox
    Linux / Mac <LeanFT installation>/Installations/Firefox

    to the Firefox Extension page.

  3. When prompted, click Install Now.
  4. Restart Firefox.
  5. When finished, make sure the HPE Functional Testing Agent extension is enabled.

Back to top

Set up Internet Explorer for LeanFT (Windows only)

  1. If you are prompted to enable the HPE Functional Testing agent, when you open Internet Explorer for the first time after you install LeanFT, click Enable.

    Otherwise, in Internet Explorer, select Tools > Manage add-ons.

  2. In the Manage Add-ons window, make sure the HPE Functional Testing Agent extension is enabled.

Back to top

Set up Microsoft Edge for LeanFT (Windows only)

LeanFT communicates with the Edge Agent for Functional Testing to test Web applications running in Edge browsers. This extension is part of the LeanFT installation.

In order to ensure LeanFT communicates with Microsoft Edge via the Agent, you must ensure that the Microsoft WebDriver is present in the LeanFT installation folder:

  1. From the Microsoft WebDriver page, download the correct version of the WebDriver for your Microsoft Edge version.

    Recommended: Update the WebDriver version after performing Windows 10 updates, because Edge requires specific WebDriver versions for each Edge version.

  2. Copy the downloaded WebDriver.exe file to the <LeanFT installation>\bin folder, and rename it MicrosoftWebDriver.exe.

  3. Open an Edge browser session together with Edge Agent for Functional Testing. You can do this in one of the following ways:

    • From the Start Menu:  Edge Agent for Functional Testing.

      For example, you would start Edge this way if you are working with the Object Identification Center (OIC) for Edge.

    • A BrowserFactory.Launch(BrowserType.Edge); statement.

    Note: LeanFT cannot work with a session of Edge that was not opened with Edge Agent for Functional Testing.

After your browsers are set up with the required extensions:

  • If the LeanFT runtime engine or the OIC is open at the time you enable the agent for a browser, close and restart the LeanFT runtime engine after the browsers are configured.
  • When you use LeanFT to test Web applications, open your browser only after the LeanFT runtime engine is active. LeanFT does not recognize objects in browsers that were opened before the runtime engine.

Back to top

Set up Safari (Mac only) for LeanFT

To install the extension, do one of the following:

GUI

  1. In <LeanFT installation>/Installations/Safari, double-click the Agent.safariextz

  2. When prompted, click Trust.
Terminal

Run the following command:

open –a safari /Library/Application Support/LeanFT/Agent.safariextz

When finished, make sure the Functional Testing Agent extension is enabled.

Back to top

Register embedded browser controls (Windows only)

If you have a non-Web application that hosts a browser control, you must register the control so that the LeanFT runtime engine can recognize the objects inside as Web objects.

You must register the browser control with LeanFT on any computer where you want to run your tests or use the OIC.

You register the control using the Register Browser Control Utility.

Note: This utility supports browser controls that are based on the Internet Explorer engine .

  1. Make sure UAC is disabled while using the utility or run the utility executable using Run As Admin.
  2. Run the Register Browser Control Utility from <LeanFT installation folder>\bin\SettingNewBrowserControlApplication.exe.
  3. Enter the path of the application containing the browser control and click Register.
  4. Restart the LeanFT runtime engine.

If needed, you can run this utility again at a later time to unregister the browser control.

Back to top

See also: