Quantum 3.2.3 release notes

Quantum 3.2.3 includes enhancements to AI Visual Comparison, improvements to execution handling and reporting, and several bug fixes and configuration updates.

Enhancements

Quantum 3.2.3 includes the following enhancements and improvements.

AI Visual Comparison enhancements

Quantum 3.2.3 introduces new steps and utility methods for AI Visual Comparison. These additions allow you to compare test results against a specified baseline and to control comparison outcomes by configuring failure criteria.

Steps

  • Perform AI Visual Comparison with a baseline ID: Compares the current screen against the specified baseline.

    Example:

    When I perform AI Visual Comparison with baseline ID "DemoBlazeHome"

  • Perform AI Visual Comparison with a baseline ID and failure criteria: Compares the current screen against the specified baseline using the specified failure criteria.

    Example:

    When I perform AI Visual Comparison with baseline ID "DemoBlazeContact" and failure criteria "addition,moved,style,error,missing"

Utility methods

The following Java utility methods are available for performing AI Visual Comparison.

Copy 
// Perform AI Visual Comparison using a specified baseline ID
Utils.aiVisualComparison("DemoBlazeHome");
// Perform AI Visual Comparison using a specified baseline ID
// with custom failure criteria
Utils.aiVisualComparison(
    "DemoBlazeHome",
    List.of("addition,moved,style,error,missing".split(","))
);

Failure criteria configuration

You can configure which visual differences cause a comparison to fail by defining failure criteria at the project level. Use a comma‑separated list in your project properties file.

Copy 
perfecto.visual.comparison.failcriteria=addition,moved,style,error,missing,value

Default value: addition,moved,style,error,uncategorized,missing,value

Execution handling improvements

Quantum 3.2.3 includes improvements to execution behavior when devices are unavailable or when device capabilities are misconfigured.

The following capabilities are now supported:

  • Generation of a single blocked report when virtual devices are unavailable or when incorrect capabilities are provided

  • Stopping of existing executions when a device ID is specified in the capabilities

    To enable stopping existing executions before a run, set the following property:

    Copy 
    release.device.before.run=1

    Default value: 0

Test configuration enhancements

Quantum 3.2.3 adds support for variables in FROM and TO filters when those filters are defined in the testng.xml file.

Bug fixes

This release includes the following bug fix:

  • Fixed an issue where screenshots were not included in Perfecto reports.

    The following properties control screenshot capture behavior:

    Copy 
    perfecto.screenshots=1
    # Default: 0 – Capture screenshots for every Find Element action

    perfecto.failure.screenshots=1
    # Default: 1 – Capture screenshots for failed commands

Notes

  • Quantum requires Java 11 as the minimum supported version.

  • The minimum required Java version will be increased in future releases.

Upgrade to Quantum 3.2.3

When upgrading to Quantum 3.2.3, note the following:

  1. If you are upgrading from a 1.x version of Quantum, review and apply the changes outlined in the Quantum 3.0.0 release notes.

  2. Update the quantum.version property in the project’s pom.xml file to 3.2.3 (or to the latest version available on Maven Central).