[Expand]General Information/viewarticle/88628/
 [Expand]Using Help System/viewarticle/81465/
 [Expand]Getting Started Tutorial/viewarticle/82003/
 [Expand]Using TestComplete/viewarticle/84431/
 [Expand]Testing Types/viewarticle/85355/
 [Collapse]Applications Testing/viewarticle/83383/
  [Expand]About Open Applications/viewarticle/81030/
  [Collapse]Web and RIA/viewarticle/81431/
   [Collapse]Web Testing/viewarticle/80569/
     Testing Web Applications - Overview/viewarticle/85521/
     Supported Web Browsers and Technologies/viewarticle/81224/
     Requirements for Web Testing/viewarticle/81781/
    [Collapse]Preparing Web Browsers/viewarticle/82334/
      Preparing Internet Explorer for Web Testing/viewarticle/81419/
      Preparing Edge for Web Testing/viewarticle/81434/
      Preparing Firefox for Web Testing/viewarticle/83667/
      Preparing Chrome for Web Testing/viewarticle/85269/
      About TestComplete Chrome Extension/viewarticle/87731/
      Preparing Chromium Embedded Framework Applications for Web Testing/viewarticle/83791/
     Creating and Recording Web Tests/viewarticle/88889/
    [Expand]Understanding Web Object Identification and Object Models/viewarticle/86802/
     HTML5 Support/viewarticle/81199/
     Support for Web Controls/viewarticle/87652/
     Support for Applications Based on Chromium Embedded Framework/viewarticle/81394/
    [Expand]Common Tasks for Web Testing/viewarticle/87816/
    [Expand]Cross-Browser Testing/viewarticle/85865/
     Considerations for Web Testing/viewarticle/81188/
     Possible Issues with Web Testing/viewarticle/81433/
   [Expand]Web Services/viewarticle/81969/
   [Expand]Flash and Flex/viewarticle/81008/
   [Expand]Mobile Web Testing/viewarticle/82855/
 [Expand]Working With Application Objects and Controls/viewarticle/81481/
 [Expand]Samples and Tutorials/viewarticle/81997/
 [Expand]Other Tools That Help You Test Better/viewarticle/82893/
 [Expand]TestComplete Licensing Guide/viewarticle/88365/
Updated: 10/12/2016 Applies To: TestComplete 12 Rating: No votes Click to rate: PoorNot badAverageGoodExcellent
Preparing Web Browsers

About SmartBear Test Extension

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:


  • Launch Chrome. Note that its menu icon (the three “hamburger” lines at the top right) becomes orange.

  • Click the Chrome menu icon and then select New extension added (SmartBear Test Extension).

    Installing SmartBear Test Extension
  • In the dialog that appears, click Enable extension.

    Enabling SmartBear Test Extension

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

© 2016 SmartBear Software. All rights reserved.
Email Send feedback on this document