Quick Checkpoints

Applies to TestComplete 15.47, last modified on January 20, 2023
Information in this topic applies to desktop and web applications.

You use Quick Checkpoints to create property checkpoints for windows and controls during the test recording quickly and easily.

In This Topic

Requirements

  • Quick Checkpoints are available only for desktop and web applications. You cannot create them for mobile applications.

  • By default, Quick Checkpoints are enabled in TestComplete. If you do not need them for some reason, you can disable them at any time. It is quite possible that you may want to disable them temporarily during the test recording and enable a few moments later.

Create a Quick Checkpoint

You create Quick Checkpoints during the test recording:

  1. If Quick Checkpoints are enabled, then TestComplete highlights a control, with which you are interacting during the test recording, with a red frame. It also shows the icon that follows your mouse pointer:

    Quick Checkpoints: The Quick Checkpoints icon

    Click the image to enlarge it.

  2. While you are moving the mouse pointer, the icon remains transparent. Stop moving the pointer and wait until the icon becomes opaque. Then move the mouse pointer to the  icon. This will show the Quick Checkpoint menu:

    Quick Checkpoints: Move to the Quick Checkpoints icon

    Click the image to enlarge it.

    The Quick Checkpoint menu lists the most commonly used properties for which you can create a property checkpoint.

  3. Select the needed property in the list.

    If the property is indexed (provides access to an array of values by index), TestComplete will open the Select Data to Check page where you can specify the index:

    Quick Checkpoints: Specifying property index

    Click the image to enlarge it.

    If the needed property is not on the list (or if you want to verify the property against a condition or baseline value other than suggested ones), click Check Other Properties:

    Quick Checkpoints: Selecting other properties to check

    Click the image to enlarge it.

    This will open the Select Data to Check page that shows the list of all object properties.

    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.

    Click Finish to close the page and add the checkpoint for the selected property.

  4. A message box will notify you that a checkpoint for the selected property has been created successfully:

    Quick Checkpoints: A checkpoint has been created notification
  5. You can continue the recording.

After the recording is over, you can see the recorded Quick Checkpoint in your test. During the test run, it will verify the selected property against the recorded baseline value:

Quick Checkpoints: A Quick Checkpoint in the recorded test

Click the image to enlarge it.

Recently Used Properties

The properties that the Quick Checkpoint menu lists depend on the current control type. The menu contains the most frequently used properties. Also, it contains recently created checkpoints. This feature helps you quickly create similar checkpoints for different controls of the same type in your tested application.

Quick Checkpoints: The list of recently used properties

Click the image to enlarge it.

The list of recent checkpoints contains the recent Quick Checkpoints, as well as property checkpoints that you created recently in the Create Checkpoint wizard.

The recently used properties are available for all objects that have the appropriate properties regardless of the object type and the application to which the object belongs.

Enabling and Disabling Quick Checkpoints

You can disable and enable Quick Checkpoints during the test recording and at design time. By default, Quick Checkpoints are enabled.

During Test Recording

Click on the Recording toolbar and then select or clear the Enable Quick Checkpoints check box:

Quick Checkpoints: Enabling Quick Checkpoints during test recording

As an alternative, to disable quick checkpoints, you can select Disable Quick Checkpoints from the Quick Checkpoints menu:

Quick Checkpoints: Disabling Quick Checkpoints during test recording
At Design Time
  1. Select Tools > Options from the TestComplete main menu.

  2. In the Options dialog, select Engines > Recording.

  3. Select or clear the Enable Quick Checkpoints check box:

    Quick Checkpoints: Enabling and disabling Quick Checkpoints at design time

Known Issues

When creating Quick Checkpoints for a Flex application running in Edge, it may take several seconds to highlight the selected element.

See Also

About Checkpoints
About Property Checkpoints
Checkpoints

Highlight search results