Browser Object

Applies to TestComplete 15.64, last modified on May 16, 2024


A Browser test object represents a running web browser - Internet Explorer, Edge, Firefox, or Chrome (see Supported Web Browsers and Technologies).

A Browser object serves several purposes:

  • It is a starting point in the hierarchy of web application objects. The web object hierarchy can be represented as follows:

     +-- Browser
          +-- Page 1
          |    |
          |    +-- Web page elements
          +-- Page 2
          +-- BrowserWindow
          |    |
          |    +-- Browser GUI elements (menus, toolbars and so on)
          +-- Top-level dialogs (for example, Open File and Save File dialogs)

    For more information, see Understanding Web Object Identification and Object Models.

  • It lets you determine the browser’s process name, executable path, file version, bitness (32-bit or 64-bit), the command line used to launch the browser, the CPU and memory usage and other information. See Browser Object Properties.

  • It provides the Close and Terminate methods for closing the browser.

In the TestComplete test object model, Browser objects are child objects of the root object Sys. For example, they are displayed as such in the Object Browser.

In tests that use Name Mapping, a Browser object is typically referred to as Aliases.browser. In tests without Name Mapping, Browser objects can be accessed using the Sys.Browser and Sys.WaitBrowser methods, for example, Sys.Browser("iexplore").

Notes: The Browser test object represents an already running browser. To launch a browser from tests, use the Run Browser keyword test operation or the BrowserInfo.Run scripting method.

To get information about all browsers installed on the computer, use the Browsers and BrowserInfo objects.


  • A license for TestComplete Web module.

  • The Web Testing plugin. This plugin is installed and enabled automatically. The plugin implements the Browser test object, as well as the web testing functionality.


See Also

BrowserWindow Object
Page Object
Browsers Object
Launch Web Browsers
Classic Web Testing
Web Object Types Used by Web and Hybrid Mobile Applications

Highlight search results