For AI agents and LLMs: a machine-readable index is available at llms.txt. A plain-Markdown version of any documentation page is available by appending .md to its URL.
Skip to main content

Create and Execute your Test Run for KaneAI Generated Tests on HyperExecute

This documentation outlines the steps to create a test run for KaneAI generated tests using Test Manager. The steps include selecting test cases, setting configurations, and running tests with HyperExecute for efficient execution. Follow the instructions carefully to ensure seamless execution of the process.

Prerequisites

  • Access to Test Manager.
  • A project with KaneAI-generated test cases.
  • Credentials for TestMu AI platform.

Step-by-Step Guide

Step 1: Navigate to the Projects Page

  • Log in to Test Manager. Navigate to the Projects page and select the desired project.
  • Proceed to the Test Cases section.

Step 2: Create a Test Run

  • Go to the Test Run section within the project.
  • Click on Create Test Run.
  • Provide the following details:
    • Name : e.g., Demo Test Run 123.
    • Description : A brief overview of the run.
    • Tags : Any label to differentiate your test run.
    • Type : Choose KaneAI Generated Test Cases.
Create Test Run panel with name, description, tags, and type fields

Step 3: Select and Add Test Cases

  • Click Next to view available test cases.
  • Select the required test cases for the run.
  • Click Add Test Case to include them.
Test case selection list showing New Experience and Classic labels and the Evidence and Coverage banner

Every test case carries a label showing the experience it was authored with, either New Experience or Classic. The banner above the list explains what that label means for your run. Evidence and Coverage reporting needs every selected test case to be authored with New Experience. Classic test cases run on the default execution mode, so a run that includes even one Classic test case produces the standard report.

tip

All KaneAI test cases with generated code are available for selection here, regardless of whether Sample Run Execution has been triggered or its outcome. Test cases where code generation has not started or is still in progress will not be available.

Step 4: Assign and Configure Test Cases

  • On the test run page, review the added test cases.
  • Assign team members in bulk.
  • Update configurations as required.
Configure Test Instances step showing a test case with missing assignee and configuration

A test case that is still missing an assignee or a configuration is flagged on its row, so you can see what is left to complete before the run can be saved.

Set Configurations

  • Choose from available desktop browser and mobile app configurations. If a new configuration is needed, click on Create Configuration button and choose from thousands of configuration options.

Create New Configuration

  • Enter configuration name and the following details to create a new Desktop configuration:
    • OS : e.g., macOS.
    • OS Version : e.g., Monterey.
    • Browser : e.g., Chrome.
    • Browser Version : e.g., 131.
    • Resolution : e.g., 1440x900.
  • Enter configuration name and the following details to create a new Real Device configuration:
    • OS : e.g., android.
    • Manufacturer : e.g., Samsung.
    • Device : e.g., Galaxy S24.
    • OS Version : e.g., 14.
    • App : e.g., Proverbial.
  • Click on Create Configuration
Add Configuration panel listing saved desktop configurations with operating system, browser, and resolution

You can also pick from your saved configurations in the Add a Configuration panel and apply them to the selected test cases. Applying a configuration to all test cases appends it to their existing configurations rather than replacing them.

Step 5: Run with HyperExecute

Once every test case has an assignee and at least one configuration, the run is ready to save and execute.

  • Review the test instances generated from your test cases and configurations.
Test instances expanded to show the configurations attached to a test case
  • Click Show execution preview to confirm what will run. The preview shows the execution type, the total number of instances, and the unique configurations involved.
  • Click Save test run.
Execution Preview panel showing execution type, total instances, and the instances summary
  • On the saved run, click Run on HyperExecute and choose Run Instances Now. To run it later instead, choose Schedule Test Run.
Saved test run page with the Run on HyperExecute menu open showing Run Instances Now and Schedule Test Run
  • Set the desired concurrency level, e.g., 5, then start the run.
Run with HyperExecute panel showing the instance overview, build parameters, and the Run with Classic Report button

The Run with HyperExecute panel summarises the run before you start it, including the number of unique tests, the unique configurations, and the concurrency. The execute button names the report you are about to generate. For a run that contains a Classic test case, or one that is not on Chrome, the button reads Run with Classic Report and the panel notes that Evidence reporting is not part of this run.

Evidence Reporting

A test run can produce an Evidence Report in place of the standard report. The Evidence Report covers the run in more detail, including coverage details and the business use cases behind the tests.

Evidence Reporting is available only when both of the following are true for the run:

  • Every test case in the run is authored with New Experience.
  • The run is configured to execute on the Chrome browser.

If either condition is not met, the run executes with the Classic report instead.

Select only New Experience test cases

On the Add Test Cases step, each test case shows the experience it was authored with.

Test case list with a New Experience test case selected and the Evidence and Coverage banner above it

Select the test cases labelled New Experience and click Add Test Cases. Leave out anything labelled Classic, because a single Classic test case makes the whole run ineligible.

Add Test Cases step for a run named Test Run Evidence with a New Experience test case selected

Configure the run to use Chrome

Give every test instance a configuration that uses Chrome, either by picking an existing Chrome configuration in the Add a Configuration panel or by creating one. Any instance on another browser makes the run ineligible.

Run with Evidence Report

When both conditions are met, the saved run shows a note confirming that an Evidence Report is available, and the Run with HyperExecute panel offers it as the primary action.

Run with HyperExecute panel showing the Run with Evidence Report button and the Run with Classic Report option in its dropdown
  • Click Run with Evidence Report to execute the run and generate the Evidence Report.
  • To run the same test run with the standard report instead, open the dropdown next to the button and choose Run with Classic Report.
note

If the run contains a Classic test case, or any instance is on a browser other than Chrome, the saved run flags which instances are blocking Evidence Reporting and the panel offers only Run with Classic Report. Adjust the test cases or the browser configuration, then reopen the panel.

Learn More

Advanced Configurations

Before clicking Execute, you can optionally click Advanced Configurations to customize your test execution. The panel groups the settings into Test Configuration, Network Settings, Replace URL, Performance, Visual Regression, Accessibility Testing, and Reports.

Advanced Configurations panel open on Test Configuration, showing console logs, network logs, timezone, and retry on failure

The following settings are available:

SettingDescription
RegionChoose a region for web tests such as eastus or centralindia to select the region from where the VM is allocated.
Mobile RegionChoose a region for mobile app tests such as us, ap, or eu to select the region from where the device is allocated.
TunnelAdd the tunnel name if you want to run using TestMu AI Tunnel for private applications. Either tunnel, dedicated proxy, or geolocation can be used in a single execution. See Tunnel Support for details.
Dedicated ProxyAdd the region of the dedicated proxy such as us or eu. Either tunnel, dedicated proxy, or geolocation can be used in a single execution.
GeolocationSet the geolocation from which you want to run your tests. See the list of supported geolocations here. Either tunnel, dedicated proxy, or geolocation can be used in a single execution.
Console LogEnable console log capture for web tests. Options: false, error, warn, info, true.
Network LogsEnable capture of network calls during the test.
Network Full HARCapture complete network requests and responses during web tests.
Network ThrottleEnable network throttling for mobile tests by defining download speed, upload speed, and latency.
TimezoneDefine the timezone for web test runs (e.g., UTC+01:00 format).
Retry on FailureEnable to retry on failure. When enabled, retries are triggered both on testRunnerCommand failure and individual test case failure. Defaults to true. See Retry on Failure for details.
Max RetriesDefine the maximum number of retries when retry on failure is enabled. Max value 5, default 1. See Max Retries for details.
Replace URLDynamically replace any pattern URL in test cases with a replacement URL for the entire test run. See Dynamic URL Replacement for details.
PerformanceEnable Lighthouse performance reports for web tests. Supported on limited OS browser combinations. May slow down execution time. See Lighthouse Performance Metrics for details.
App ProfilingEnable app performance metrics tracking for native mobile app tests. See App Performance Analytics for details.
Android App IDSpecify an Android app ID (lt://<APP_ID>) to override the existing app in the test instance configuration.
iOS App IDSpecify an iOS app ID (lt://<APP_ID>) to override the existing app in the test instance configuration.
Visual RegressionAdd visual testing configuration: select browsers, viewports, devices, and orientation. See Visual Testing with SmartUI for details.
AccessibilityEnable accessibility checks (WCAG 2.1 AA) with best practices and needs review options. Available for web with Chrome and Edge browsers only. May slow down execution time.
Report EnabledSet to true to enable report generation for the test run. Select either HTML or Extent report format. Only one can be active at a time. Reports are accessible from the HyperExecute Job page after execution. See below.
Report Email ToAn array of email addresses to receive the test run report via email after execution. Maximum 10 email addresses. Only works when report is enabled.
note

Test case failure retries are supported only for code exported from May 10, 2026 onwards. For previously exported code, retries are triggered only on test runner command failure. To use this capability, regenerate the code export for your test cases in Test Manager.

Reports

Enable the Reports option in Advanced Configurations to generate reports for your test run. You can enable either an HTML report or an Extent report. Only one can be active at a time. Reports are supported for both web and mobile test executions.

  • Generate HTML Report: Toggle to Yes to generate an HTML report for the test run, available in the HyperExecute dashboard after execution.
  • Generate Extent Report: Toggle to Yes to generate an Extent report for the test run, available in the HyperExecute dashboard after execution.
  • Email Addresses: Add one or more email addresses (separated by space or enter) to receive the report via email after execution. You can add up to 10 email addresses.
Reports option in Advanced Configurations

Accessing the Report

Once your test run execution is complete, you can access the generated HTML report from the HyperExecute Job page. Navigate to the job and click on the Reports section to view or download the report.

HTML report on HyperExecute Job page

HTML Report Overview

The generated HTML report includes:

  • Summary: Job metadata (job number, labels, username, build time, date), test summary with pass/fail counts and donut charts, scenario summary, task analytics, and browser-level breakdown.
  • Test Cases: A detailed list of all test cases with their status (pass/fail), OS, OS version, browser, duration, and links to view the test or watch the video recording.
HTML report summary page HTML report test cases page

Extent Report Overview

The generated Extent report provides a rich interactive view of test execution results, accessible from the HyperExecute Job page. It includes:

  • Dashboard: A visual summary of the test run with pass/fail statistics and trend data.
  • Test Details: Step-by-step breakdown of each test case with status and screenshots.
Extent report dashboard overview Extent report test detail view

Email Report

If you added email addresses, recipients receive an email with a summary of the test run results along with the HTML report as an attachment.

Test run report received via email
tip

Reports are also available when configuring Scheduled Test Runs.

  • Click Execute to run the tests.

Monitor Execution on HyperExecute

  • Navigate to the HyperExecute page.
  • Observe the discovery and rapid execution of test cases.

Video Explanation

Test across 3000+ combinations of browsers, real devices & OS.

×
Schedule Your Personal Demo
Book Demo

Help and Support

Related Articles