BlinqIO Documentation

Run a Test Scenario ​

You can run any test scenario from the Features page using a unified Run button. This supports running tests locally, with AI Recovery, or generating a command for CI/CD pipelines.

  1. Navigate to the Features page and select the test scenario you want to run.

    image-20250617165004661

  2. Click the Run button and choose one of the following options:

    image-20250617165057963

Execute All Steps (Local Execution) ​

Runs the test scenario directly in your browser using the BlinqIO Editor.

  1. Select Execute all steps from the Run menu.

    image-20250617165130321

  2. In the confirmation popup, choose where you want to run the scenario (Cloud or Local), then click Execute Scenario.

    image-20250617165401003

    A new browser window opens along with a terminal, and the test begins running.

    image-20250617165538894

At the end of the test run, you will see the message Command finished, you can exit this window... in the BlinqIO Editor console.

image-20250617165659387

Execute Scenario with AI Recovery ​

Runs the scenario locally with automatic error recovery powered by AI.

image-20250617165748517

  • If a step fails, the system will attempt intelligent retries or fallback locators.
  • Root Cause Analysis (RCA) will be triggered automatically for failed steps.

Note

Learn more about Root Cause Analysis here.

Execute via CI/CD ​

Use this to copy the command needed to run the scenario from a terminal or pipeline.

  1. Select Execute via CI/CD from the Run menu.

    image-20250617165834712

  2. A modal appears with the command pre-filled with environment, tags, and scenario details.

    image-20250617165903513

  3. Copy and use the commands in your CI/CD pipelines or paste them into a terminal to run the tests.

    RunCommandLineTestExample

Note

Make sure you have Node.js (version 18 or greater) installed on the server. Verify the installation with:

bash
node -v
npm -v

Customize Run Commands ​

When running from CI/CD or terminal, you can modify the command using the following options:

image-20250617171201119

Set Custom Run Report Name ​

bash
--run-name="My Regression Run"

Change Browser ​

By default, tests run on Chromium. Use the BROWSER option to change this:

bash
BROWSER=firefox      # or webkit

RunOnDifferentBrowser

Headless Mode ​

If you're running tests on a server without a GUI, add HEADLESS=true to run the tests without opening a browser window.

bash
HEADLESS=true

HeadlessModeRun

Run a Specific Scenario by Name ​

You can use the --name flag in the command to run a particular scenario based on its title.

bash
npx cross-env BLINQ_ENV=staging TOKEN=your_token --name="User checkout process" cucumber-js

This runs only the scenario with the name User checkout process.

Combine Options ​

You can combine multiple configuration options. For example, running a test on Firefox in headless mode:

bash
npx cross-env BROWSER=firefox BLINQ_ENV=... TOKEN=... BVT_FORMATTER="ANALYSIS" cucumber-js --format bvt