[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/
     [Collapse]Property Checkpoints/viewarticle/71353/
       About Property Checkpoints/viewarticle/73782/
       Creating Property Checkpoints/viewarticle/71652/
       Parameterizing Property Checkpoints/viewarticle/75022/
       Alternatives to Property Checkpoints/viewarticle/73717/
       Updating Property Checkpoints/viewarticle/70960/
       Tips on Selecting Properties to Verify/viewarticle/73488/
     [Expand]Object Checkpoints/viewarticle/68813/
     [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
Property Checkpoints

About Property Checkpoints

A property checkpoint is a test operation that verifies that an object property has the expected value in the tested application. For example, it verifies the text in a text box or the state of a check box. This helps you check whether your tested application works correctly.

In keyword tests, property checkpoints are performed using the Property Checkpoint operation:

Property checkpoint in a keyword test

In scripts, property checkpoints are performed using the aqObject.CheckProperty method:


Call aqObject.CheckProperty(Aliases.Orders.MainForm.OrdersView, "wItem(5, 0)", cmpContains, "Mark Twain")


aqObject.CheckProperty(Aliases.Orders.MainForm.OrdersView, "wItem(5, 0)", cmpContains, "Mark Twain");


aqObject.CheckProperty(Aliases.Orders.MainForm.OrdersView, "wItem(5, 0)", cmpContains, "Mark Twain")


aqObject.CheckProperty(Aliases.Orders.MainForm.OrdersView, 'wItem(5, 0)', cmpContains, 'Mark Twain');

C++Script, C#Script

aqObject["CheckProperty"](Aliases["Orders"]["MainForm"]["OrdersView"], 'wItem(5, 0)', cmpContains, 'Mark Twain');

How a Property Checkpoint Works

When you run a test, TestComplete reads the current value of the specified property of the tested object (this object must exist in the application at that moment), compares it with the expected value and reports the result. Besides the "equals" check, property checkpoints let you perform "not equals", "greater than", "less than", "contains" and other kinds of checks. String values can be compared in case-sensitive and case-insensitive modes.

Note that property checkpoints can only be used for verifying simple values: strings, numbers, boolean values, dates and so on. They cannot check complex values, such as objects or arrays. To verify such properties, use one of the alternative approaches described below.

How to Create Property Checkpoints

You can add property checkpoints to your test during test recording and at design time. TestComplete provides the Property Checkpoint wizard that assists you in creating and configuring property checkpoints. For detailed instructions on using the wizard, see Creating Property Checkpoints.

Checkpoint Results

During the test run, property checkpoints compare the actual and expected property values and post the comparison results to the test log. If the property values match, the checkpoint logs a success message; otherwise, it logs an error message. The Additional Info panel displays the checkpoint parameters and the difference between the expected and actual property values (if any).

If you want to customize log messages of property checkpoints, use one of the alternative comparison approaches described below. For example, perform comparison using the if … then … else statement and comparison operators and post the success and failure log messages from the then and else branches, respectively.

Property Checkpoint Alternatives

In addition to property checkpoints for property verification, you can use one of the following approaches:

  • To verify multiple object properties at once, use object checkpoints.

  • To compare the actual and expected property values, use the if … then … else statement and comparison operators such as =, >, >=, <, <= and so on. This way, you can implement custom verification logic and post custom success and failure messages to the test log.

  • Use the Compare Properties keyword test operation or the aqObject.CompareProperty scripting method. They are similar to property checkpoints, but they post less detailed output to the test log.

Updating Property Checkpoints

If a tested object whose property you want to verify has been modified in your application under test, your property checkpoint may fail. In order for the checkpoint to be passed successfully, update your checkpoint data. For information on how to do this, see Updating Property Checkpoints.


TestComplete includes sample test projects (one per each supported scripting language) that demonstrate how to use property checkpoints in tests:

<TestComplete Samples>\Desktop\Checkpoints\Property

See also
Property Checkpoints | Property Checkpoint Operation | CheckProperty Method | Object Checkpoints

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