Testing

Create or Select a Node

Begin by creating a custom node using our AI Node Generator or selecting a node from the Nodeverse that aligns with your workflow requirements.

Open the Node Editor

Access the Node Editor </> to view and modify the configuration of your chosen node. You can even customize nodes using JavaScript or TypeScript to meet your specific needs. (For more information on editing nodes, refer to our guide on node customization.)

Testing Nodes

On the left side of the Node Editor, you'll find the Testing Node. This feature allows you to manually input values that correspond to the inputs of the node you're testing. This way, you can ensure that your node's logic effectively covers various edge-case scenarios.

Test Node Logic

Once you've input the test values, click the "Test Node" button. This action evaluates your node's logic against the provided test case without requiring you to save or deploy the entire workflow. In case of any errors, you'll receive a detailed error message, once you click on the exclamation mark, that you can use to debug your node's logic.

Build Your Workflow

Create your workflow by adding triggers and logic nodes that define the sequence of actions to achieve your goals. (Or pick up a pre-built template or a set of pre-built nodes via the Nodeverse)

Access the Testing Mode

At any point in your workflow-building process, click on the "Test" button located in the top-right menu.

Configure Parameters

Before running the test, provide any necessary parameters. For instance, in the case of an HTTP Trigger, you can specify the request body that your trigger will receive.

Run the Test

Click "Run" to initiate the test. Your logic nodes will execute one after another, validating their functionality. Successfully executed nodes will display a green checkmark ✅, while any failing nodes will be marked with a red exclamation mark ❗️.

Debugging

In case of node failures, the testing mode reveals the exact node responsible for the error ocurred. Clicking on the exclamation mark reveals the error code and message, helping you pinpoint and address issues efficiently.

Access Saved Examples

Navigate to the Examples section within the Node Editor or the Testing Mode. Here, you'll find a list of all your saved examples.

Use an Example

Select an example from the list and click play ▶️ button. The test inputs will be automatically populated with the values from the saved example, allowing you to re-run the test with the same parameters.

Open the Node Editor and click Tests

Navigate to the Node Editor and click on the Tests tab to access the testing feature. Before you write tests for any node you'll require to save the node to the My Library, to ensure we create a separate copy of the node for testing purposes without affecting the original workflow node.

Creating a New Test

As soon as the node gets saved to the My Library, you can start creating test cases for the node. Click on the + New Test button to access the unit testing feature.

What are Assertions in Unit Testing?

Assertions are statements that check if a condition is true. In the context of unit testing, assertions are used to compare the actual output of a node with the expected output. If the condition is true, the test passes; otherwise, it fails. Assertions help identify discrepancies between the expected and actual behavior of your node, making it easier to debug and fix issues.

Common types of assertions include:

• Equality Assertion: Checks if the actual output is equal to the expected output.
• Truthy/Falsy Assertion: Checks if the actual output is truthy or falsy.
• Contains Assertion: Checks if the actual output contains a specific value or structure.
• Customized Assertion: Allows you to define custom conditions for validating the output.

By using assertions, you can ensure that your nodes perform as expected and handle various scenarios correctly.

Add Assertions

Assertions are used in unit testing to verify that the output of your node matches the expected result. They help ensure that your node behaves correctly under various conditions. You can Create multiple assertions to validate your test result Here's how you can add assertions to your unit tests:

Add Assertions: After defining the test inputs, add assertions to verify the output. Click on the "Add Assertion" button and specify the expected output for the given inputs. You can add multiple assertions to validate different aspects of the node's behavior.

Run the Test

Once you've added the test inputs and assertions, click the "Run Test" button to execute the test. The test results will display the status of each assertion, indicating whether it passed or failed. You can review the test results to identify any discrepancies between the expected and actual output of your node.

Passed Test:

Failed Test: