BlinqIO Documentation

Execute Tests from External CI/CD ​

Use the Execute via CI/CD option to run scenarios directly from your CI pipeline or terminal. BlinqIO provides a pre-filled command you can customize with environment variables, tags, and run options.

Get the CI/CD Run Command ​

  1. From the Features page, click the Run button and select Execute via CI/CD.
  2. A modal appears with a command pre-filled with environment, token, and scenario details.
  3. Copy and use this command in your CI/CD pipelines or paste it into your terminal to execute the scenario.

Note

Ensure Node.js (version 18 or later) is installed on the machine. Verify using:

bash
node -v
npm -v

Customize Run Commands ​

You can modify the command to suit your CI/CD environment or execution needs.

Set a Custom Run Report Name ​

Use --run-name to label your run for easy identification in reports.

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

Change Browser ​

By default, tests run using Chromium. Use the BROWSER option to change the browser.

bash
BROWSER=firefox      # or webkit

RunOnDifferentBrowser

Run in Headless Mode ​

On CI servers or non-GUI environments, set HEADLESS=true to run tests without opening a browser window.

bash
HEADLESS=true

HeadlessModeRun

Run a Specific Scenario by Name ​

Use the --name flag to run only the scenario that matches a given 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 Multiple Options ​

You can pass several options in a single command. 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