Skip to main content

Run Configurations Dialog

  • 6 minutes to read

The Run Configurations dialog contains run configuration management options.

Run configurations determine the following aspects of the test run:

To open the dialog, click the Settings button button next to the Run Configuration drop-down menu in the main toolbar.


Don’t forget to manually save the changes that you make when you interact with the Run Configurations dialog.

Run Configurations Dialog

Configuration Management

Configuration List

The side panel contains a list of available run configurations. TestCafe Studio automatically generates the following basic run configurations:

  • One for each of the local GUI browsers.
  • One for each of the local headless browsers.
  • One with all the local GUI browsers.

Select a run configuration to view and modify it.


When you add or remove entries from the run configurations list, TestCafe Studio does not save the changes automatically. Make sure to apply the changes manually.

New Configuration

Click the New Configuration sidebar button to create a new run configuration. TestCafe adds a new entry to the configuration list and opens the settings view for that configuration.

Delete a Configuration

Click the Remove button in the bottom of the dialog window to delete a run configuration.

Run Configuration Settings





The name of the configuration. TestCafe Studio displays this name in the sidebar of the Run Configurations dialog, as well as in the Run Configurations drop-down menu.

Default report view

Report view formats determine the content and appearance of run reports. The default installation of TestCafe Studio includes the following report formats: Grid, Dashboard, Json, List, Minimal, Spec, and Xunit. Read this guide to learn about custom report formats.


The Browsers section determines which browsers run tests when you use the run configuration.

TestCafe Studio scans the user’s machine on startup to create a list of compatible local browsers. If you just installed a browser, and can’t find it in the list, restart TestCafe Studio.

Tests can run in multiple browsers simultaneously.

  • Check a browser entry to add it to the run configuration.
  • Uncheck a browser entry to remove it from the run configuration.
  • Check the Remote browser option to run tests in remote browsers.

Browser Options

TestCafe can pass launch options to most local browsers.


TestCafe Studio cannot set custom launch options for remote browsers because users manually launch remote browsers. Read the remote browser guide for more information.



Browser Support

CLI flags

Command line options to include during browser launch.

All local browsers except Safari.

Emulated device

Device emulation settings for Chromium-based browsers.

Google Chrome (GUI and headless), Chromium (GUI and headless), Edge Chromium (GUI only).

Load user profile

TestCafe launches browsers with an empty user profile, unless you enable this option. Empty user profiles do not contain browser extensions, bookmarks, nor other traces of past user activity; this ensures greater test consistency. Check the Load user profile box to load the default user profile instead.

Google Chrome, Mozilla Firefox and Microsoft Edge. GUI mode only.

Test Failure and Debugging

{| |- ! Setting ! Description |-

| Fail if a JavaScript error occurs on a page

Fail the test in case of a client-side JavaScript error.

| Skip uncaught server errors

Ignore uncaught server-side errors or unhandled promise rejections.

| Take a screenshot if a test fails

Take a screenshot of the test page on test failure (local devices only).

| Debug mode

Activate debug mode.

| Quarantine mode

Enable quarantine mode to eliminate false negatives and detect unstable tests. When a test fails, TestCafe quarantines it, and repeats it until the test yields conclusive results.

| Pause the test when it fails

Activates debug mode when tests fail.

| Stop the test run if a test fails

Skips remaining tests after the first test failure.

| Prevent page content caching

Disables page caching for a particular test. You may inadvertently navigate to a cached page that contains outdated automation scripts: for example, when you activate a Role. This can lead to TestCafe errors. Use this option to disable page caching.

| Allow new windows

If you disable this option, TestCafe Studio does not obey requests to open new browser windows. Instead, the application opens their URLs in the current window and navigates back after the request to close the window.

| Disable native automation | Uncheck the “disable native automation” box to automate Chromium-based browsers with the Chrome DevTools Protocol. Native automation allows TestCafe Studio to emulate user actions with greater precision, speed, and stability. If changes to the emulation engine have an unexpected impact on the behavior of your tests, you may wish to turn native automation off. | }





Selector Timeout

Time in milliseconds. If TestCafe fails to resolve an element selector query within this time limit, the test fails.


Assertion Timeout

Time in milliseconds. If an assertion does not succeed within this time limit, the test fails. TestCafe executes the assertion multiple times within the time window, performing measurements and calculations anew with each attempt.


Page Load Timeout

Time in milliseconds. Under normal circumstances, TestCafe only starts the test after the window.load browser event. However, if the browser exceeds this time limit after the DOMContentLoaded event, TestCafe does not wait for the window.load event and starts the test anyway.


AJAX Request Timeout

Time in milliseconds. If an AJAX request does not resolve within this time limit, the test fails.


Page Request Timeout

Time in milliseconds. Tests fail if the server does not fulfill the test page request within this time limit. Enable the Retry Test Pages option to retry unsuccessful test page requests.


Browser Init Timeout

Time in milliseconds. If the browser initialization process takes longer than this amount of time, tests fail.


Advanced Options




Reports path

The directory that stores run reports.


Screenshots path

The root directory for test screenshots. See the following help topic for details: Screenshot Directory.



Test execution speed. Decimal number between 0.01 and 1.



The number of browser instances that execute tests concurrently.


Save the Changes

TestCafe does not autosave the changes you make when you interact with the Run Configurations dialog, even when you add or remove run configurations.

Click Save to apply all the changes you’ve made in the run configurations dialog.