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 button next to the Run Configuration drop-down menu on the main toolbar.
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.
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.
Command line flags used to configure browser settings.
All local browsers except Safari.
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
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.
Activates the debug 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.
Allow new windows
Allows the tested pages to open new windows.
The directory where TestCafe Studio saves test run reports.
The base directory where TestCafe Studio saves screenshots. See the following help topic for details: Screenshot Directory.
Specifies the time (in milliseconds) element selectors can obtain target elements.
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
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.
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.