[Expand]General Information/viewarticle/75299/
 [Expand]Using Help System/viewarticle/68624/
 [Expand]Getting Started Tutorial/viewarticle/73031/
 [Collapse]Using TestComplete/viewarticle/70372/
  [Expand]TestComplete User Interface, Projects and Settings/viewarticle/74317/
  [Collapse]Creating, Recording and Running Tests/viewarticle/74604/
   [Expand]Naming Objects/viewarticle/69317/
   [Expand]Creating Tests/viewarticle/69687/
   [Expand]Managing Tested Applications/viewarticle/72027/
   [Collapse]Checkpoints and Stores/viewarticle/71813/
     [Expand]Property Checkpoints/viewarticle/71353/
     [Collapse]Object Checkpoints/viewarticle/68813/
       About Object Checkpoints/viewarticle/73332/
       Creating Object Checkpoints/viewarticle/73584/
       Parameterizing Object Checkpoints/viewarticle/70604/
       Alternatives to Object Checkpoints/viewarticle/68630/
       Updating Object Checkpoints/viewarticle/72693/
     [Expand]Table Checkpoints/viewarticle/70091/
     [Expand]File Checkpoints/viewarticle/68628/
     [Expand]XML Checkpoints/viewarticle/74617/
     [Expand]Database Checkpoints/viewarticle/74704/
     [Expand]Region Checkpoints/viewarticle/75749/
     [Expand]Mobile Checkpoints/viewarticle/68549/
     [Expand]Clipboard Checkpoints/viewarticle/71944/
     [Expand]Manual Checkpoints/viewarticle/73516/
     [Expand]Web Service Checkpoints/viewarticle/69819/
     [Expand]Web Accessibility Checkpoints/viewarticle/74819/
     [Expand]Web Comparison Checkpoints/viewarticle/69754/
   [Expand]Running Tests/viewarticle/68992/
   [Expand]Handling Playback Errors/viewarticle/71027/
   [Expand]Keyword Testing/viewarticle/68860/
   [Expand]Test Visualizer/viewarticle/74945/
   [Expand]Exploring Applications/viewarticle/73626/
   [Expand]Debugging Tests/viewarticle/68755/
  [Expand]Test Results/viewarticle/74393/
  [Expand]Enhancing Tests/viewarticle/69325/
  [Expand]Teamwork and Integration Into QA Process/viewarticle/71012/
  [Expand]Extending TestComplete/viewarticle/72159/
  [Expand]Automating TestComplete/viewarticle/74580/
  [Expand]Best Practices/viewarticle/70336/
 [Expand]Testing Types/viewarticle/71476/
 [Expand]Applications Testing/viewarticle/69187/
 [Expand]Working With Application Objects and Controls/viewarticle/72879/
 [Expand]Samples and Tutorials/viewarticle/71571/
 [Expand]Other Tools That Help You Test Better/viewarticle/68606/
 [Expand]TestComplete Licensing Guide/viewarticle/74980/
Updated: 9/2/2015 Applies To: TestComplete 11 Rating: No votes Click to rate: PoorNot badAverageGoodExcellent
Object Checkpoints

About Object Checkpoints

An object checkpoint is a test operation that verifies that an object’s properties contain expected values. For example, it can verify that a control in your application under test is enabled, visible on screen and located at the specified position.

In keyword tests, object checkpoints are performed using the Object Checkpoint operation:

Object checkpoint in a keyword test

In scripts, object checkpoints are performed using the Objects.CheckpointName.Check method:


Call Objects.wndNotepad.Check(Sys.Process("notepad").Window("Notepad", "*").Window("Edit"))


Objects.wndNotepad.Check(Sys.Process("notepad").Window("Notepad", "*").Window("Edit"));


Objects.wndNotepad.Check(Sys.Process("notepad").Window("Notepad", "*").Window("Edit"))


Objects.wndNotepad.Check(Sys.Process('notepad').Window('Notepad', '*').Window('Edit'));

C++Script, C#Script

Objects["wndNotepad"]["Check"](Sys["Process"]("notepad")["Window"]("Notepad", "*")["Window"]("Edit"));

How to Create Object Checkpoints

You can add object checkpoints to your tests during the test recording and at design time. TestComplete provides the Object Checkpoint wizard that assists you in creating and configuring object checkpoints. For detailed instructions on how to use the wizard to insert checkpoints in your tests, see Creating Object Checkpoints.

When you create an object checkpoint, TestComplete stores collection of the object’s properties with their values and, optionally, collections of its child objects’ properties with their values to the project’s Stores | Objects collection.

How Object Checkpoints Work

An object checkpoint takes only one parameter - the name of the object whose properties you want to verify. Properties to be verified and baseline values to be used for comparison are specified by the Stores | Objects collection used by the checkpoint.

When you run your test, the object checkpoint obtains the specified object in your application (this object must exist at that moment), checks its actual property values and its child objects’ property values against expected values stored in the Objects collection and reports results.

Object Checkpoint Results

During the test run, object checkpoints check actual values of object properties against stored values and post check results to the test log. If the objects are identical (if the Store data of the selected object and its children option was enabled, TestComplete also checks all child objects), the checkpoint returns True and posts a successful checkpoint message () to the test log.

Otherwise, the checkpoint returns False and posts an error message () to the test log. The Additional Info panel displays a table containing properties that fail verification with their actual and expected values.

Object checkpoint results
Note: If you want to change the type of the message posted to the test log on verification failure or customize the log message of the checkpoints, use one of the alternative approaches described below.

Alternatives to Object Checkpoints

In addition to object checkpoints, you can use the following approaches to verify object properties:

  • Create a custom verification procedure that obtains the desired object and its properties and compares them with expected values.

  • Use the Objects.Compare method. The method is similar to object checkpoints, but it posts less detailed output to the test log.

Note: To verify a single property, use property checkpoints.

For more information, see Alternatives to Object Checkpoints.

Updating Object Checkpoints

If an object under test whose properties you verify has been modified in your application under test, your object checkpoint may fail. In order for the checkpoint to be passed successfully, update the collection of baseline values stored in the project’s Stores | Objects collection.

For information on how to do this, see Updating Object Checkpoints.


TestComplete includes sample projects (one for each supported language) that demonstrate how to create object checkpoints:

<TestComplete Samples>\Desktop\Checkpoints\Object

See also
Object Checkpoints | Object Checkpoint Operation | Check Method | About Objects Collection | About Property Checkpoints

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