How to use the Testbook

Navigating your tests

On the left there is a collapsible navigation for you to use to explore your tests.

The top level, which is all you see initially, are your Test Suites

Click on the arrow (>) next to a Test Suite to see the Testsets it contains.

Each Testset contains one or more Tests. Click on the arrow (>) next to a Testset to see the Tests it contains. Click on the name of the Testset to see all of the tests with their details in the main panel.

Click on an individual Test to load the Testset in the main panel and take you to a view of that specific Test.

Selecting Tests to Run

Before running your tests, you can choose which tests to run by selecting them.

In the navigation every Test Suite, Testset and Test has a button next to it (+). Click this button to add the entire Test Suite (and all of the Testsets it contains), the Testset (and all of the Tests it contains), or just individual Tests.

In the main panel, the Testset has an "Add All" button which will add all Tests from that Testset to your list of selections.

Also in the main panel, each Test has an "Add" button, which will add that test to your list of selections

Once you have selected one or more tests you will see all selected tests appear underlined in the navigation.

At the top of the screen, a counter tells you how many individual tests you have selected (e.g. "10 selected").

Selected tests will persist across browser sessions.

Unselecting Tests

If you have selected a test you did not mean to, or you wish to start selecting again from scratch, you can remove tests from your selections

To remove all tests, click "Clear all selected" from the navigation at the top

To remove a test via the navigation on the left, click the (-) button by the Test Suite, Testset, or Test to remove them (and any of their children).

In the main panel, click "Remove All" by the Testset title, and "Remove" by each individual Test.

Downloading Tests for Running

You can download all tests by clicking "Download all tests" in the top navigation. This will give you a ZIP file containing CSVs for each Testset.

From the main panel, with a Testsest displayed you can click "Download Testset". This will give you a CSV for the full Testset.

If you have selected one or more files, you can click "Download selection" in the top navigation. This will give you a single CSV with all the selected tests. Tests will be ordered by Suite (alphabetically), then Testset (alphabetically) and then Test (in order of definition), with appropriate headers and separators in the file.

Running the tests

You can, of course, run the tests directly in the Testbook, but there is no way to collect user feedback. Checkboxes by test results are provided in the display as a way for you to keep track of where you are in your testing, but the state of these checkboxes cannot be persisted.

To run the tests for real with multiple test users it is recommended to download the tests you want to run as one or more CSVs, and then upload them to a shared space (e.g. Google Docs) and make a copy of the selected tests for each test user.

This Excel Template is provided which contains conditional formatting and layout which provides a reasonable display of the testbook CSV for use by end users.