Run Configurations Dialog

  • 3 minutes to read

The Run Configurations dialog allows you to create, modify, and delete run configurations. This dialog opens when you click the Settings button button next to the Run Configuration drop-down menu on the main toolbar.

Run Configurations Dialog

The dialog's left panel lists the available run configurations. When you select a configuration, the dialog's right section displays its settings organized into several categories.

Run Configuration Settings


Setting Description
Name The configuration's name. It is displayed in the Run Configurations drop-down menu on the main toolbar.
Default report view The test report's format used in the Report view. The available formats are grid, json, list, minimal, spec, xunit.


This section lists locally installed browsers TestCafe Studio detects. You can select on which browsers you want to run tests.

You can also select the Remote browser checkbox to run tests on remote machines. See Running Tests in Remote Browsers.

Tests can run in multiple browsers simultaneously. You can use the Select All and Deselect All buttons to select or remove the selection of all browsers.

Review Fails and Debug

Setting Description
Fail if a JavaScript error occurs on a page Specifies whether a test is flagged as failed if a JavaScript error occurs on the tested page. If unchecked, JavaScript errors are ignored.
Take a screenshot if a test fails Specifies whether TestCafe Studio takes a screenshot of the tested page when a test fails. Note: TestCafe cannot take screenshots on remote devices.
Debug mode Activates the debug mode.
Quarantine mode Enables the quarantine mode for tests that fail. In this mode, a failed test is executed several times. The test result depends on the outcome (passed or failed) that occurs most often. That is, if the test fails on most attempts, the result is failed. If the test result differs between test runs, the test is marked as unstable.
Pause the test when it fails Specifies whether to activate the debug mode when a test fails.

Advanced Options

Setting Description Default
Reports path The directory where test run reports are saved. /TestCafeStudio/reports
Screenshots path The base directory where screenshots are saved. See Screenshot Directory. /TestCafeStudio/reports/screenshots
Selector timeout Specifies the time (in milliseconds) element selectors can obtain target elements. 10000
Assertion timeout Specifies the time (in milliseconds) an assertion can take to pass. The assertion retries to pass multiple times within this timeout, and each time it verifies the actual value. The test fails if the assertion could not be completed successfully within the timeout. 3000
Speed Specifies the test speed from 0.01 to 1. 1
Concurrency Specifies the number of browser instances to execute tests concurrently. See Concurrent Test Execution. 1

Managing Configurations

To create a new run configuration, click New Configuration. TestCafe Studio adds a new configuration to the configuration list.

To edit a run configuration, select it in the dialog's left panel and modify its settings. Next, click Apply to apply the changes without leaving the dialog, or OK to apply the changes and close the dialog.

To remove a run configuration, click the Remove button.