Creating Property Checkpoints

Applies to TestComplete 14.92, last modified on September 16, 2021

You can create property checkpoints in several ways:

Quick Checkpoints

  1. Start recording your test.

  2. Make sure that Quick Checkpoints are enabled:

    Property Checkpoint: Enable Quick Checkpoints

  3. During the test recording, TestComplete highlights UI elements, with which you are interacting, with a red frame. It also shows the icon near your mouse pointer.

    Move the mouse pointer to the object that you want to verify and wait until the red frame appears.

  4. Stop moving the mouse pointer and wait until the icon becomes opaque. Move the mouse pointer to the icon:

    Property Checkpoint: Quick Checkpoints icon

  5. TestComplete will show the list of the most commonly used properties for which you can create Quick Checkpoints:

    Property Checkpoint: Quick Checkpoints menu

  6. Select the property you want to check.

    If the property is indexed, TestComplete will show the Select Data to Check page where you can select the index of the property’s value column.

    If the needed property is not on the list, click Check Other Properties. TestComplete will show the Select Data to Check page. The page lists all properties of the underlying object. Select the property (or properties) to check, verification parameters and the expected value:

    1. Select the property you want to check from the list.

      To find the needed property faster, you can type its name or value in the Search box. The wizard will filter out the property list according to the text you are typing.

    2. Select the Selected check box for the property you want to check.

    3. In the Condition column, select the needed verification condition.

    4. In the Value column, enter the expected value of the object property. By default, it holds the current property value.

      The object property value and the expected value should be of the same type. If the compared values are of different types, TestComplete will try to convert the object property value to the type of the expected value and then perform a verification. In this case, the comparison may be performed incorrectly.
    Property Checkpoint: Selecting property

    Click Finish to complete the checkpoint creation.

  7. TestComplete will add a checkpoint to your test and show a notification about it:

    Property Checkpoint: A Quick Checkpoint has been added

Create Checkpoints by Using the Checkpoint Wizard

Note for Mobile Testing: To create a property checkpoint for an object in a mobile application, you can select the object on the Mobile Screen. Make sure that the Mobile Screen window is not hidden when you launch the checkpoint wizard.

In addition, note that the application under test and the mobile device, where it is running, must be prepared for testing in order for TestComplete to be able to access the application’s objects.

1. Launching the Wizard

The way you open the wizard depends on the test creation mode:

  • If you are recording a test–

    1. Click Add Check on the Recording toolbar.

    2. In the Checkpoint Wizard, select Text or property, and then click Next.

      Property Checkpoint: Selecting a checkpoint type

  • If you are editing a keyword test –

    1. Select the Checkpoints category in the Operations panel of the Keyword Test editor.

    2. Find the Checkpoint Wizard operation in the list and drag it to your test. In the Checkpoint wizard, click Text or property.

      – or –

      Find the Property Checkpoint operation in the list and drag it to your test.

      Property Checkpoint: Adding property checkpoints to keyword tests

  • If you are editing a script –

    1. Open the script to be edited.

    2. Click on the Code Editor toolbar:

      Adding checkpoints to script tests

    3. In the Checkpoint Wizard, select Text or property, and then click Next.

2. Specifying a Control, Window, or Object to Check

Select a control (for example, a button, a text box, a list view, and so on), or a window, or any other object whose property you want to check.

You can specify the object in one of the following ways:

Tips for selecting objects:

You may find the second technique more convenient than using the target icon, because you can manipulate applications before actually selecting an object. For example, you can open the tested application window containing the desired control and so on. Unlike using the target icon, with this technique, you can point to popup windows, tooltips, and other objects that are hidden in the application when being inactive.

To select a non-onscreen object, such as a process, enter the object name manually.

Instead of selecting the object, you can copy its name from the Object Browser, Object Spy, keyword test, or script code beforehand and paste it into the Object box.

Despite the way you specify the object name, you can change or correct it directly in the Object box.

TestComplete will display the name of the selected object in the Object box and show the object image in the Preview area.

Property Checkpoint: Selecting object

If the Map object names automatically option is selected, TestComplete automatically adds the specified object to the Name Mapping repository (if it is not there already). Your tests will take the object alias from the repository.

After you selected the object, click Next to proceed.

3. Selecting an Object Property or Field to Verify

On the Select data to check page of the wizard, click Properties to view the list of object properties and fields. (If you are configuring the Property Checkpoint operation, the wizard will show the property list automatically.)

Select one or several properties or fields to check, verification parameters and the expected value:

  1. Select the property you want to check from the list.

    By default, the wizard shows only the suggested properties. To view all the available properties, click More Properties.

    To find the needed property faster, you can type its name or value in the Search box. The wizard will filter out the property list according to the text you are typing.

  2. Select the Selected check box for the property you want to check.

  3. In the Condition column, select the needed verification condition.

  4. In the Value column, enter the expected value of the object property. By default, it holds the current property value.

    The object property value and the expected value should be of the same type. If the compared values are of different types, TestComplete will try to convert the object property value to the type of the expected value and then perform a verification. In this case, the comparison may be performed incorrectly.
Property Checkpoint: Selecting property

5. Closing the Wizard

Click Finish to exit the Checkpoint wizard. TestComplete will add the checkpoint statement for the specified property to your test.

If you are creating a property checkpoint while editing a test script, then the generated checkpoint code will be displayed in the Copy Text to Clipboard dialog. You will be able to copy this code to the clipboard and then paste it to the desired place in your script.

See Also

Property Checkpoints
About Property Checkpoints
Checkpoint Wizard
Mobile Screen Window
Selecting an Object on the Mobile Screen (Android Testing)
Select an Object on the Mobile Screen (iOS Testing)

Highlight search results