Applies to TestComplete 12.40, last modified on October 6, 2017

Web test recording and playback in Google Chrome is made possible by the SmartBear Test Extension. This extension is automatically installed in Chrome during the TestComplete installation, and is shared among all user instances of Chrome.

SmartBear Test Extension adds its icon to the Chrome navigation bar - this way, you can confirm that the extension is installed and enabled.

SmartBear Test Extension icon in Chrome

Installing SmartBear Test Extension

The SmartBear Test Extension is automatically installed during the TestComplete installation, provided that Chrome is already installed (either for the current user or for all users on the computer).

If you installed Chrome after TestComplete, you may need to install the extension manually. To do that:

  • Launch the TestComplete installation program and select the Modify mode.

  • Follow the on-screen instructions to complete the installation.

After the extension is installed (or updated), you may need to restart Chrome in order to enable the extension. Chrome needs some auto configuring after the new extension is installed. When the extension is installed to an already running Chrome instance, it does not function unless Chrome is restarted.

Since version 25, Chrome disables all third-party extensions upon installation and update. The first time you start Chrome after installing or updating it, you need to enable the extension manually:


If your testing environment is deployed automatically and it includes unattended installation of TestComplete, TestExecute or Google Chrome, enabling the extension manually is not an acceptable option. In this case, you can add the SmartBear Test Extension to the list of force-installed Chrome extensions. Learn about the workaround and its limitations.

If the extension’s icon does not appear on the Chrome navigation bar, make sure the extension is enabled in Chrome:

  • From Chrome’s main menu, select Settings and then select Extensions on the left.

    – or –

    Navigate to the chrome://extensions page.

  • Locate SmartBear Test Extension in the list and make sure that it is enabled (that is, the Enabled check box is selected).

Reinstalling SmartBear Test Extension

If you remove SmartBear Test Extension from Chrome, it will be blacklisted and TestComplete will not be able to automatically reinstall or update it. In this case, to reinstall the extension:

  • From Chrome’s main menu, select Settings and switch to the Extensions page.

    -- or --

    Navigate to the chrome://chrome/extensions/ page.

  • In the <Program Files>\<Common Files>\SmartBear\tcCrExtension\<alphanumeric_ID> folder, locate the SmartBear Test Extension file - the tcCrExtension.crx file.

  • Drag the tcCrExtension.crx file to the Extensions page in Chrome.

  • Confirm the installation when prompted.

Extension Options

The SmartBear Test Extension provides a number of options to customize web testing recording and playback capabilities. To view or change these options, click the arrow on the left of the SmartBear Test Extension on the Extensions page in Chrome.

The following options are available:

  • Allow in incognito - Enable this option to test web pages during private browsing.

  • Allow access to file URLs - Select this option to test local web pages or web pages stored as local files (their URLs start with the file:// prefix).

After you change these options, you must restart Chrome. Otherwise, TestComplete will not see web pages in Chrome.

See Also

Preparing Chrome for Web Testing
Considerations for Web Testing
Testing Web Applications
Requirements for Web Testing