Checkpoint Wizard - Selecting Comparison Parameters (Web Comparison Checkpoints)

Applies to TestComplete 15.73, last modified on March 04, 2025

On this page of the Checkpoint wizard, you specify parameters of the web comparison checkpoint you are creating.

To create a new set of comparison parameters
  1. Click Select and save comparison settings.

  2. Enter the name of the new WebComparison element in the Save as a new item to Stores edit box.

    Note: The name is used to address the element from scripts, so it must be a valid script identifier. To specify the name that will match the naming rules adopted by all supported scripting languages, enter a string that starts with a letter and that contains only letters, digits, and underscore symbols.
  3. Specify the comparison settings:

    • Mode - Specifies one of the following verification modes:

      • Compare entire page - The checkpoint saves the whole HTML document to the Stores project item and checks the stored document against the actual document displayed by the web page under test.

      • Compare only tag structure - During verification the checkpoints will build a tree of web page elements for both. These trees include only tag names and do not include attributes, attribute values and element values. The checkpoint compares these trees and returns the comparison result.

      • Compare only specified tags - The checkpoint will check only those web page elements that are specified by the following settings:

        • Links - The checkpoint builds a collection of A elements for both stored and actual pages and then compares these collections. The comparison fails, if the collections contain a different number of items, or if the text or attributes of a stored element differ from the text or attributes of the actual element.

        • Images - The checkpoint builds a collection of IMG elements for both stored and actual pages and then compares these collections. The comparison fails if the collections contain a different number of items, or the elements’ attributes differ.

        • Input elements - The checkpoint builds a collection of INPUT elements for both stored and actual pages and then compares these collections. The comparison fails if the collections contain a different number of items, or the element attributes differ.

    • Read content from a server - This option specifies whether to read the web page's content from the browser’s window or from the web server. If this option is enabled, the checkpoint gets the address of the tested web page and reads its content directly from the server, otherwise, it gets the page's content from the browser window.

      Tip: The browser window’s content can differ from the original content from the server, that is, if you want to make the comparison more stable, enable this option.
To use an existing set of comparison parameters
  1. Click Use stored settings.

  2. Select the needed element from the Stores item drop-down list.

To create a checkpoint, click Finish. TestComplete will create a new WebComparison project element (if needed) and then will create the checkpoint. If you added the checkpoint to a keyword test, then TestComplete will append the Web Comparison Checkpoint operation to the test. If you created the checkpoint for script code, then TestComplete will generate and display the comparison code.

To close the wizard and abort the checkpoint creation, click Cancel.

See Also

About Web Comparison Checkpoints
Web Comparison Checkpoint Operation
Classic Web Testing

Highlight search results