Checking Whether an Object Exists

In keyword tests, use the If Object operation to verify that an object exists. For example:

1. Add the If Object operation to your keyword test. TestComplete will display the Operation Parameters wizard.

2. Specify the object to verify, and click Next.

3. In the list of available states to check, choose Exists and click Finish.

4. To specify the operations to execute if the object exists, add the needed operations to your test as child items of the If Object operation.

5. To specify the operations to execute if the object does not exist, add the Else operation right after the If Object operation, and then add the needed operations as child items of the Else operation.

Desktop

Web (Cross-platform)

Desktop

Click the image to enlarge it.

Web (Cross-Platform)

Click the image to enlarge it.

Note: By default, TestComplete waits for an object to become available for a period specified by the Auto-wait timeout project property. You can set a custom timeout to increase or decrease that time

1. Get the desired object using the appropriate WaitNNN method. For example:

   • In desktop applications, use WaitProcess, WaitWindow, WaitWinFormsObject and so on.

   • In web applications, use the WaitBrowser and WaitElement methods.

   • In mobile applications, use the WaitProcess and WaitElement methods.

   Tip: To find out which wait method to use, see what method is used to address the desired object in the Object Browser or the recorded code and add the Wait prefix to the method name. To get the object by its name, use the WaitChild method.

2. Use the Timeout parameter of the wait method to set the maximum time (in milliseconds) to wait for the object. Use the 0 timeout to get the object and return immediately.

3. Check the Exists property of the resulting object.

If you get the object the ordinary way, without the Wait method, and the object does not exist, its properties and methods, including the Exists property, cannot be accessed. TestComplete will report the “Object does not exist” error if you try getting the object’s Exists property. That is why the Wait methods should be used. If the object is found, the method returns it, and the object’s Exists property is True. If the object is not found, the method creates and returns a “stub” object whose Exists property is False. Therefore, checking the Exists property will not cause the “Object does not exist” error.