Enabling web browsers

To use HCL OneTest™ UI to test HTML applications that run on Internet Explorer you need not manually enable the browser. It is automatically enabled when you begin recording a script. If you use Mozilla Firefox or Google Chrome, you must enable the browser manually.

Before you begin

HCL OneTest UI automatically enables the environments for functional testing. As a result, you can directly record functional test scripts without enabling components manually. The automatic enablement takes place under certain conditions and has limitations. For more information about the conditions and limitations, see Automatically enabled environment for functional testing.

HCL OneTest UI does not automatically enable Google Chrome browsers. If you use a Google Chrome browser, you must enable it manually. For instructions, see the related task Enabling Google Chrome browsers.

If required, you can manually enable Internet Explorer or Mozilla Firefox browsers as described in the following procedure.

To enable browsers for testing, you must log on as an administrator. On Microsoft Windows 7 or later, and on Microsoft Vista operating systems, you must also run HCL OneTest UI by using the Run as Administrator option.

  • HCL OneTest UI supports testing on any version of Mozilla Firefox 18.0 and later. When you enable Firefox version 18.0 and later as a test environment, an extension is installed.
  • In Firefox, you need to enable the browser for recording the tests. HCL OneTest UI facilitates playing back the tests directly in Firefox without enabling the browser.
  • Web application testing is not supported on IE 11 in Java environments from 9 onwards.
Important: If you enabled Mozilla Firefox version 18 or later or Google Chrome browser for HCL OneTest UI, the latest Java update must be associated with the browser. If not done, security messages prompt up when you open the browser and Java will be blocked.


  1. Click Configure > Enable Environments for Testing from HCL OneTest UI to invoke the Enable Environments dialog box (the enabler).
  2. Click the Web Browsers tab.
    1. Click Search. The Search for Web Browsers dialog box opens.
    2. Search for the browser by using any of the following search method:
      • Select Search All to let the enabler locate all the browsers on your system. HCL OneTest UI scans all of your hard disk drives or partitions and lists the browsers in the Web Browsers list.
      • Select Search In to browse to a specific disk drive or root directory to search.
      Note: You must not use the Search All option to find browsers on Linux or UNIX systems. Instead, use the Search In option and browse for it.
    3. Click the Search button.
  3. Select the browsers that you want to enable by clicking them in the Web Browsers list. You can select multiple browsers by using the Ctrl key while you are selecting. Click the Select All button if you want to enable all of them.
  4. Click Enable. The selected browser or browsers are enabled for HTML testing. The enabled browsers will be indicated in parentheses after each browser name in the list.
    Note: In HCL OneTest UI version 9.1 and later, to enable Firefox, JRE associated with Firefox must be enabled. Once Firefox is enabled, the browser is launched when the Test button is clicked. Users are then prompted to install a Firefox extension for HCL OneTest UI support. Once the extension is installed, Firefox must be restarted. To ensure that the extension is enabled, in Firefox select Tools > Add-ons > Extensions and verify that the extension is enabled.
  5. Select a browser to be the default and click the Set as Default button.
  6. Click Close.
  7. Test that your browser is enabled properly by clicking the Test button to run the Browser Enablement Diagnostic tool.


The browser is enabled for testing.

  • If the enabler fails to find a browser in the registry or on your system, you can click the Add button. Clicking the Add button brings up the Add Browser dialog box, which you can use to locate the browser. After you select it and click Add, the browser will then be added to the Web Browsers list in the enabler, and you follow the same steps to enable or disable it. If you try to add a file that is not a browser, you see an error and it is not added to the list.
  • If your browser is not enabled, the Recording Monitor is blank when you try to record against an HTML application. For this reason, leave the Recording Monitor in view while recording. If you see this symptom, you must run the enabler.
  • To test applets in HTML, you must enable your JREs. To enable JREs for Java™ testing, see the Enabling Java environments topic.
  • The first time that you run HCL OneTest UI, it automatically enables the JVM of your browser's Java plug-in so that HTML recording works properly. If you install a different JVM, you must rerun the enabler to enable it. However, if you experience an error with the Java plug-in during HTML testing, or when you are trying to launch the Verification Point Comparator from the HTML log, you must make sure your plug-in is configured properly. See Enabling the Java plug-in of a browser topic for instructions.
  • If you are using Firefox and you must manually enable the browser, use the Enable button as described. When you select a browser and click Enable, it launches the browser and you are prompted to click in the browser to enable it. Click the link, and then click OK if you see a message box.

What to do next

You can test that your browser is enabled properly by clicking the Test button. Clicking the Test button opens the Browser Enablement Diagnostic Tool. If you suspect your browser is not enabled properly, run this tool and follow the instructions that it gives to solve the problem.
  • Additionally, for Mozilla Firefox, make sure that the Firefox Enabler extension is enabled in the Add-ons manager in Firefox. To open the Add-ons manager in Firefox, click Tools and then click Add-ons. In the Extensions tab, verify whether the HCL HOTUI Firefox Enabler 1.0 extension (for Firefox version 17 and earlier) or the HCL Functional Tester Firefox Enabler 9.1 (for Firefox version 18 and later) is enabled. If it is disabled, enable it.
  • If the enablement fails for a Google Chrome browser the error CRFCN0794E is displayed when you try to record on the browser, see the related topic Troubleshooting functional tests in Google Chrome browsers.