Execution and Debugging

Learn how to run your flows, interpret results, and diagnose failures.

Running a Flow

Full Execution

To execute the entire flow:

1. Make sure the flow is saved
2. Click the Run button (▶️) in the top bar
3. Wait for completion — nodes will display real-time status indicators

Image: Canvas showing nodes with status indicators during execution

Execution Status

Analyzing Results

After execution, click on any node to see its results in the properties panel:

Results Tab

Outputs

The outputs of each node are accessible to subsequent nodes via expressions. For example, after running an HTTP Request, the outputs will be:

{
  "status": 200,
  "body": "...",
  "json": {
    "id": 1,
    "name": "João",
    "email": "joao@exemplo.com"
  }
}

You can then access this data in subsequent nodes:

{{ steps["http-request"].outputs.json.name }}  →  "João"
{{ steps["http-request"].outputs.status }}     →  200

Screenshots (Evidence)

For web nodes (Web Flow and Smart Locators), captured screenshots appear as clickable thumbnails. Click to view at full size.

Debugging Failures

Identifying the Problem Node

1. Look for nodes with a red border (🔴) on the canvas
2. Click on the failing node
3. Check the error message and the logs

Common Error Messages

Web Flow / Smart Locators

HTTP Request

Database

SSH

Using Logs for Diagnosis

The logs of each node provide details about each executed step. For web nodes, logs show:

Navigated to: https://exemplo.com/login
Filled: "usuario@exemplo.com" on [getByLabel("E-mail")]
Clicked: [getByRole("button", { name: "Entrar" })]
Assert passed: textContains "Bem-vindo" — true

If a step failed, the log will show exactly which step and why:

Navigated to: https://exemplo.com/login
Filled: "usuario@exemplo.com" on [getByLabel("E-mail")]
ERROR: Click failed after 3 attempts: [getByRole("button", { name: "Login" })] — element not found

Debugging Tips

1. Disable Headless Mode

For web tests, disable headless mode on the node to see the browser in action:

• On the Web Flow or Smart Locators node, uncheck Headless
• Run the flow and observe the browser

2. Add Wait Steps

If elements appear with a delay, add wait steps before interacting:

• wait with visible mode waits for the element to appear
• wait with networkIdle mode waits for all network requests to finish

3. Capture Screenshots for Diagnosis

Enable screenshots in before mode to see the page state before each action. This helps identify whether the page was in the expected state.

4. Check Expressions

If a node fails with an unexpected value, add a Log node before it to inspect the values:

Token value: {{ steps.login.outputs.json.token }}
Status: {{ steps["http-request"].outputs.status }}

5. Use the "Continue on Failure" Toggle

To diagnose multiple failures at once, enable Continue on Failure on verification nodes. This allows the flow to continue and you can see all failures in a single run.

Execution Report

After each run, QANode automatically generates a PDF report with:

• Execution summary (status, duration, date)
• Details of each step (status, logs, outputs, duration)
• Captured screenshots
• Errors encountered

The report is available in the project's execution list and can be downloaded or sent by email.

Next Steps

• Node Reference — Complete details of each node type
• Expressions — Master the dynamic data system