Skip to main content

Overview

Test execution in Supatest happens in two primary modes: headless execution for automated runs from the test explorer, and headed execution for live browser debugging in the editor.

Execution Modes

Headless vs Headed Execution

Headless Execution

Run tests without a visible browser window. Tests execute in the background. How to run headless:
  • From Test Explorer: Right-click test → Run
  • From Test Details: Click Run button
  • From Test Plans: Scheduled tests run headless
Best for:
  • CI/CD pipelines
  • Scheduled test plans
  • Running multiple tests quickly
  • Regression testing

Headed Execution (Live Browser)

Run tests with a visible browser that you can watch and interact with. How to run headed:
  • Open test in Editor
  • Click Run to start live browser
  • Watch execution in real-time
Best for:
  • Debugging failing tests
  • Building and testing new steps
  • Visual verification
  • Understanding test behavior

Quick Start

Run a Single Test

  1. Find the test in Test Explorer
  2. Right-click → Run
  3. Or open test → click Run button

Run in Live Browser

  1. Open test in Editor
  2. Click Run in toolbar
  3. Watch the live browser panel

Run Multiple Tests

  1. Select tests (Shift+click or Ctrl+click)
  2. Right-click → Run Selected
  3. Tests queue and execute

Browser Options

BrowserEngineWhen to Use
ChromiumChrome/EdgeDefault, most websites
FirefoxGeckoCross-browser testing
WebKitSafariiOS/macOS compatibility