Unit Testing

This document covers how to use the Unit Testing functionality within Insomnia Designer.

How to create a Unit Test Suite

Import & Select your OpenAPI Document. I am using the Petstore API.

Navigate to the Debug tab to ensure that the requests are generated and work:

Head over to the Test tab and click “New Test Suite”, after naming your test suite click "Create Suite":

How to delete a Unit Test Suite

Click dropdown arrow on the test suite you’d like to delete in the sidebar

and then click “Delete Suite”

How to create a Unit Test

Unit tests in Insomnia Designer rely on the Chai framework. Below you will learn how to create a unit test.

Select the Unit Test Suite you wish to create a Unit Test in and click the “Create Test” button:

You will be presented with a dialog modal asking you to name the Unit Test:

Once you have named your Unit Test, click “Create Test”, you will now be presented with the Unit Test interface which contains the Unit Test name, debug request dropdown, settings button and the Unit Test code editor where you can write your unit test in JavaScript:

Select the request you would like to use for your unit test from the “-- Select Request —” dropdown (we suggest using a simple GET request for your first unit test):

And run the test to ensure that it works correctly:

How do I test response bodies?

You can test the response payload by accessing the .data attribute of the response variable:

	const response = await insomnia.send();

How do I test JSON payloads?

By default response.data will be a string if you wish to validate it as JSON you must first convert response.data to JSON using JSON.parse:

	const response = await insomnia.send();
	const body = JSON.parse(response.data);


How do I test JSON payload properties?

Since unit tests rely on the chai library for unit testing we can test properties easily once we have converted our response payload to JSON:

	const response = await insomnia.send();
	const body = JSON.parse(response.data);
	const item = body[0];


How do I test multiple requests in a single unit test?

You can add additional requests, or target a specific request by pressing CTRL+Space while the unit test code area is focused, from the dropdown menu you can select to run the current selected request or a request by a specific id:

When choosing to send a request by ID, you will be presented with a modal asking which request to send:

The code editor will be pre-populated with the request / response boilerplate for the request selected:

How do I chain requests?

Chaining requests is as simple as following the request chaining guide, and then selecting the chained request from the "-- Select Request --" dropdown.

How do I change request values?

Since unit tests rely on the requests and the selected environment under the debug tab, the only way to alter a request being made in a unit test is to alter the request, and it’s environment variables under the debug tab.

An example is when you’re missing an environment variable:

Let’s add the petId to our request environment, and click Done:

Now when you run a request the unit test will use this value:

The same goes for authentication, queries, headers, and request body.

How can I debug my unit test?

First, open the developer tools:

Now open the “console” tab, it should be open by default:

Now that we have opened the dev tools and have the console open, we can console log values in our unit test to the console:

	const response = await insomnia.send();
	const body = JSON.parse(response.data);
	const item = body[0];


You should now see something like the following after running your unit test:

How to rename a Unit Test?

You can rename a unit test by double clicking on the unit test’s name and changing the contents once editable:

Let’s add OK

Once we click outside of the editable area the value is saved.

How to delete a Unit Test?

You can delete a unit test by clicking the “Delete” option inside of the settings menu located next to the Select Request dropdown.