List of useful Test Objects in TestComplete

While we develop the automation script, we generally deal with the application functionality, objects and events. But at the same time, we need to get the information on window objects, on-screen objects and scripting objects etc to achieve the required. In order to get these information as well as to provide access to any specific features, TestComplete has several test objects (like Sys, Builtin, aqUtils etc)  that can be used frequently. In this post we will discuss about some of these useful general test objects and their commonly used methods and properties. 

Sys Object : Sys Object is the frequently used object in TestComplete Scripting, it allows to Control and access all the processes and information about the system outside TestComplete.Different actions like  interact with active windows, simulate key presses etc can be controlled by its methods and properties. for example Sys.Clipboard is used to put text or images to the clipboard or retrieves the clipboard data, Sys.Desktop property is used to access the properties and methods of the Desktop object. The entire screen of PC desktop can can be accessed using this property. We can also get the Host Name, Computer name, Domain Name, OS Name etc using SYS property. Similarly we have different methods like Find, FindAll to access the child objects. Process to access a particular application by its name or index.

for example –

' Storing and getting an image
Set Sys.Clipboard = Sys.Process("notepad").Window("Notepad", "* - Notepad").Picture
Log.Picture(Sys.Clipboard)

' Storing and getting text
Sys.Clipboard = Sys.Process("notepad").Window("Notepad", "* - Notepad").WndCaption
Log.Message(Sys.Clipboard)

Know more about Sys Object here.

BuiltIn Object : BuiltIn object allows access to different feature of the TestComplete. Most of the methods of the BuiltIn object is considered obsolete and retained only for compatibility with scripts written in earlier versions of TestComplete. New versions of methods can be found in the objects aqFile, aqConvert, aqObject and others.

We can skip the object name (BuiltIn) when calling these methods in TestComplete scripts.

Here are some of the methods of the object BuiltIn, are not currently considered to be obsolete:

The other methods will be of interest to users TestComplete version 6 and below, since these versions still has no facilities aqFile, aqEnvironment etc.

Runner Object : The Runner object is used to control script execution from the script. It includes methods that allow you to stop the script execution and to run routines by their names.

Useful Methods

Options Object : This is a very useful object that allows to change some settings and TestComplete project, such as the model used objects in web applications, image parameters (size, quality, etc.), on / off logging, the variables of the project (project variables ), etc. The Code Completion window of the Code Editor displays the list of properties (options) available for the Options object.

TestComplete Helper Object : TestComplete has multiple program objects, some of them are designed for accessing TestComplete’s project items and settings from tests while other objects facilitate testing tasks and provide various helper routines.

The helper program objects are available in each of supported scripting languages, so their functionality is script-independent.