Collection & Folder Runner

Testfully's Folder Runner allows you to run a collection of requests within a folder or sub-folder. This feature is useful when you want to test multiple requests in a sequence or run a series of requests in a specific order.

Features

This section describes the features available in the Folder Runner in more detail.

Selecting Requests

When you run a folder, by default, all requests within the folder will be selected for execution. You can choose to run only specific requests by selecting them before starting the run.

• To select a request, click on the checkbox next to the request name.
• To select all requests, click on the ... button next to "Run" and select Select All.
• To deselect all requests, click on the ... button next to "Run" and select Deselect All.

Order of execution within a folder

When you run a folder, Testfully will execute the requests in the order they appear in the folder. You can change the order of requests by dragging and dropping them within the folder.

• To move a request up, drag the request and drop it above the request you want to move it before.
• To move a request down, drag the request and drop it below the request you want to move it after.

Serial, Parallel and Random Execution modes

Testfully allows you to run requests in a folder in three different modes:

• Serial: Requests are executed one after the other in the order they appear in the folder, or the order you have set by dragging and dropping them.
• Parallel: Requests are executed simultaneously. This mode is useful when you want to run multiple requests at the same time.
• Random: Requests are executed in a random order. This mode is useful when you want to test the stability of your API by running requests in a random order.

Concurrent Requests

When you run requests concurrently, you can specify the number of concurrent requests to run at the same time. This allows you to control the load on your server.

Delay in between requests

You can specify a delay in milliseconds to wait between requests. This is useful when you want to simulate a real-world scenario where requests are not sent immediately after each other.

Source of Variables

When you run a folder, you can choose the source of variables to use in the requests. You can select global variables or environment variables to use in the requests. Testfully will always load any available folder or collection variables and use them in the requests, regardless of the source you choose.

Dataset Files

You can use dataset files to run requests with different data sets. When you run a folder, you can select a dataset file to use in the requests. Testfully will load the dataset file and use the data in the requests.

• Testfully supports both .csv and .json dataset files.
• For CSV files, the first row is considered as the header row, and the remaining rows are considered as data rows.
• For JSON files, the data should be an array of objects. Each object represents a data set.
• You can upload a JSON dataset that is an object with a key-value pair. Testfully will treat the object as a single data set.
• You can supply Testfully environment or global files as is to the dataset file input.

Preview & Edit Dataset Files

Once a dataset file is uploaded, you can click on the edit button next to the file name to open the file in the editor. You can then review the content of the file and make any necessary changes. Once you're done, click on the X button to close the editor and save the changes.

Iterations

You can specify the number of iterations to run the folder. This allows you to run the folder multiple times with the same settings. When a dataset file with multiple rows is used, each row will be considered as an iteration.

Iteration Concurrency

When you run iterations, you can specify the number of iterations to run concurrently. This allows you to control the load on your server when running multiple iterations.

Running a Folder

To run a folder, follow these steps:

1. Hover over the folder in the sidebar and click on the ... button.
2. Click on the Run button.
3. Customise the run settings if needed, then click on the Run button to start the run.

Support

If you have any questions or need help with the Folder Runner, please contact us at support@testfully.io or via the in-app chat. We're here to help you!