Run Configurations Dialog

  • 5 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





The configuration’s name. TestCafe Studio displays this name 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, and xunit.


This section lists locally installed browsers that are detected by TestCafe Studio. You can select the browsers with which you want to run tests.

You can also select the Remote browser checkbox to run tests on remote machines. See the following help topic for details: 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.

Browser Options

This section allows you to specify options for each selected local browser. TestCafe Studio passes these options to the browsers when it launches them.


You cannot specify browser options for remote browsers, because you start these browsers manually.



Supported Browsers

CLI flags

Command line flags used to configure browser settings.

All local browsers except Safari.

Emulated device

Chromium device emulation settings. Specify these settings to enable mobile device emulation in Chromium-based browsers.

Google Chrome (UI and headless), Chromium (UI and headless), Microsoft Edge (Chromium-based; UI only).

Load user profile

Launches the browser with the current user profile (usually includes extensions, bookmarks, etc.). If unchecked, the browser is launched with an empty profile.

Google Chrome, Mozilla Firefox, and Microsoft Edge. Not supported in headless mode.

Test Failure and Debugging



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, TestCafe Studio ignores JavaScript errors.

Skip uncaught server errors

Specifies whether TestCafe Studio ignores uncaught errors or unhandled promise rejections that occur on the server. If unchecked, the test fails when an error or promise rejection occurs.

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, TestCafe Studio executes a failed test multiple 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 debug mode when a test fails.

Stop the test run if a test fails

Specifies whether TestCafe Studio should stop the test run after the first test failure.

Prevent page content caching

Disables page caching. Enable this option if tests fail unexpectedly after authentication.

In order to guarantee seamless test execution, browsers that run TestCafe tests should always fetch the tested page from the TestCafe proxy server. This ensures that automation scripts on the page are in sync with the server side.

However, if the browser uses a cached copy of the page, automation mechanisms may be interrupted. Among other issues, this could reset authentication data in the cookies, local, and session storage during navigation. The Prevent page content caching option fixes these issues.

Allow new windows

Allows the tested pages to open new windows.

If a page tries to open a new window when this option is disabled, TestCafe Studio opens the URL in the same window. The browser navigates to the previous page when the test scenario returns to the original window.

Advanced Options




Reports path

The directory where TestCafe Studio saves test run reports.


Screenshots path

The base directory where TestCafe Studio saves screenshots. See the following help topic for details: Screenshot Directory.


Selector timeout

Specifies the time (in milliseconds) element selectors can obtain target elements.


Assertion timeout

Specifies the time (in milliseconds) an assertion can take to pass. The assertion retries to pass multiple times within this timeout, and verifies the actual value each time. The test fails if the assertion could not be completed successfully within the timeout.


Page load timeout

Specifies the time elapsed (in milliseconds) after the DOMContentLoaded event, during which TestCafe Studio waits for the window.load event to fire. After the timeout passes or the window.load event is raised (whichever happens first), TestCafe Studio starts the test.



Specifies the test speed from 0.01 to 1.



Specifies the number of browser instances to execute tests concurrently. See the following help topic for details: Concurrent Test Execution.


Managing Configurations

Click New Configuration to create a new run 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.