Creating Web Audits Checkpoints

Applies to TestComplete 15.20, last modified on January 19, 2022

Use Web Audits checkpoints to run audits against a web page and learn how the page performs. You can create Web Audits checkpoints in several ways:

Create Quick Checkpoints during test recording

Create checkpoints by using the Create Checkpoint Wizard both during test recording and at design time

Quick Checkpoints

  1. Start recording your test.

  2. Make sure that Quick Checkpoints are enabled:

    Web Audits 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 any object on the web page you want to verify and wait for a red frame to appear.

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

  5. TestComplete will show the Quick Checkpoints context menu:

    Web Audits Checkpoint: Quick Checkpoints menu
  6. Select the Add Web Audits Checkpoint item from the context menu.

  7. TestComplete will add a Web Audits checkpoint to your test and show a notification about this:

    Web Audits Checkpoint: A Quick Checkpoint has been added

Create Checkpoints by Using the Checkpoint Wizard

1. Launch the Wizard

The way you call the wizard depends on whether you are recoding a test or creating a test manually:

  • If you are recording a test

    1. Click Add Check on the Recording toolbar.

    2. In the Checkpoint Wizard, select Web metrics, and then click Next.

      Web Audits Checkpoint: Selecting the 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 Web metrics.

      – or –

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

      Web Audits Checkpoint: Adding Web Audits 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 Web metrics, and then click Next.

2. Specify Checkpoint Parameters

On the next page of the wizard, specify the web page to be verified, the needed audits and the threshold values for them. You can also specify the type of the device to be used for emulation:

Web Audits Checkpoints: Specifying Audits

To specify checkpoint parameters, do the following:

  1. Enter the web page URL to be verified in the URL of the page to be checked edit box.

  2. Enable required audits in the Audits to run section and specify threshold values for them:

    • Performance - The checkpoint will verify the performance of the page is being checked.

    • Accessibility - The checkpoint will verify how well the page complies with the content accessibility rules.

    • Best practices - The checkpoint will verify how well the page complies with the best practices used to improve the quality of software.

    • Search engine optimization (SEO) - The checkpoint will verify how well the page is optimized for search engine scanning.

    • Progressive web app (PWA) - The checkpoint will verify how well the page complies to best practices for Progressive web applications.

    Threshold scores for all of these audits can be specified as a number between 0 and 100.

    By default, the threshold value is 90. It indicates a well-performing web page. To learn more about threshold scores, see the Lighthouse tool documentation.

  3. Specify the type of the device you want to emulate to check the behavior of your web page on it:

    • Desktop - The web page behavior will be checked on a desktop computer.

    • Mobile - The web page behavior will be checked on an emulated mobile device (Nexus 5X will be emulated).

3. Close the Wizard

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

If you are creating a checkpoint while editing a script test, TestComplete will show the Copy Text to Clipboard dialog containing the generated checkpoint code. Copy it to the Clipboard and paste it to the needed place in your script test.

See Also

Web Audits Checkpoints
About Web Audits Checkpoints
Checkpoint Wizard
Analyzing Web Audits Checkpoint Results

Highlight search results