Documentation Index

Fetch the complete documentation index at: https://docs.unqork.io/llms.txt

Use this file to discover all available pages before exploring further.

Tests

Prev Next

The Tests panel lets Creators create, run, and review test cases for the current module. Test cases define an expected input and output so Creators can verify module behavior before publishing. To open the panel, select Tests from the Tools drop-down.

The Module Builder Tests panel showing the Module Tests header with Tests and Logs tabs, a Create Test Case button, Run All button, search field, status filter, Tests enabled and Auto-fix checkboxes, and a list of four test cases each with Active badge and run, toggle, and delete actions.

Module Tests

The header of the Tests panel displays the panel title alongside a count of test cases in parentheses. Two tabs let Creators switch between the test case list and the execution log.

Control Description
Tests tab Displays the list of test cases for the current module.
Logs tab Displays a record of past test executions and their results.
plus icon Create Test Case Creates a new test case with a default title. Visible when the Tests tab is active.

Tests Tab

The Tests tab displays all test cases for the module and provides controls for running and managing them.

Configuration

Two checkboxes at the top of the Tests tab control global test behavior.

Setting Description
Tests enabled When checked, this setting enables test execution for the module.
Auto-fix When checked, this setting lets the Build Agent automatically attempt to fix failures detected during a test run.

Test List

The test list displays below the configuration checkboxes. The top left displays a count of test cases currently shown. Use the Search field and the status filter drop-down to narrow the list.

Control Description
Search Filters the test list by test case name or description.
Status filter Narrows the list by test status. Options include: All statuses, Active only, or Inactive only.
play icon Run All Runs all visible test cases and sends the results to the Build Agent.

Each row in the test list displays the test case name and an Active or Inactive status badge. The following actions are available on each row.

Action Description
play icon Run Runs this individual test case and sends the result to the Build Agent.
toggle-right icon Active / toggle-left icon Inactive Toggles the test case between Active and Inactive. The status badge on the row updates to reflect the change. Active test cases are included in Run All execution; Inactive test cases are skipped.
trash-2 icon Delete Opens a confirmation dialog before permanently deleting the test case. This action cannot be undone.

Test Detail

Clicking a test case row opens the detail view for that test case. The detail view displays the full configuration of the test and lets Creators edit, run, or delete it.

The Module Builder Test Detail view showing the test case title, description, Active badge, ID, Created and Updated dates, Group field, and an Input section with a JSON code block containing test script steps.

Detail Header

Control Description
← Back to Tests Returns to the test list without saving any unsaved changes.
trash-2 icon Delete Opens a confirmation dialog before permanently deleting the test case. This action cannot be undone.
play icon Run Test Runs this test case and sends the result to the Build Agent.

Title and Description

The test case name displays as a heading at the top of the detail view. Select the  Edit icon next to the title to edit the name and description inline. Select Save to apply changes or Cancel to discard.

Below the title, a metadata row displays the following details.

Field Description
Status badge Displays Active or Inactive to indicate whether this test case is included in Run All execution.
ID The system-assigned unique identifier for the test case.
Created The date the test case was created.
Updated The date the test case was last modified.
Group The group this test case belongs to, if one has been assigned, like Input.

Input

The Input section displays the data sent to the module when this test case runs. The value is shown as a formatted JSON code block.

{
  "fieldKey": "value"
}

The input defines the starting state of the module submission for this test run.

Expected Output

The Expected Output section displays the result the module must produce for the test to pass. The value is shown as a formatted JSON code block.

{
  "fieldKey": "expectedValue"
}

During a test run, the Build Agent compares the module's actual output against the expected output to determine whether the test passes or fails.

Test Plan

When present, the Test Plan section describes the logic this test case is meant to verify, in plain text.

Logs Tab

The Logs tab displays a record of every test execution for the current module. Select the Logs tab in the panel header to open it.

The Module Builder Tests panel on the Logs tab showing an empty state with a clipboard icon and the message 'No execution logs found. Run tests to see results here.' with an All results filter drop-down.

A count at the top left displays the count of results currently visible. Use the status filter drop-down to narrow the log by result type.

Filter Description
All results Displays every execution result.
Passed only Displays only results with a PASSED status.
Failed only Displays results with a FAILED or ERROR status.

Each row in the log displays the test case name, a status badge, and the timestamp of the execution. Status badges use the following values.

Badge Description
PASSED The module's output matched the expected output for this test case.
FAILED The module's output did not match the expected output.
ERROR The test could not complete due to an execution error.

Click View on any log row to navigate to that test case's detail view.


Changelog

Date Change
2026-05-27 Initial publication.