Skip to main content

Preferences/Settings Dialog

  • 3 minutes to read

The Preferences/Settings dialog contains the following settings:

To open the dialog:

  • On macOS: Select Preferences from the TestCafe Studio menu.
  • On Windows and Linux: Select Settings from the File menu.

Preferences Dialog

Network Settings

Options

Description

Default

Hostname

The hostname of the server that runs TestCafe Studio.

Auto Detect is on. TestCafe Studio uses the computer’s hostname or local IP address.

Record Ports

Two network ports to use when TestCafe Studio records tests. The second port is necessary to access cross-domain resources. Input two different numbers in the [0 — 65535] range that do not include your Run Ports.

Auto Detect is on.  TestCafe Studio automatically selects suitable open ports.

Run Ports

Two network ports to use when TestCafe Studio runs tests. The second port is necessary to access cross-domain resources. Input two different numbers in the [0 — 65535] range that do not include your Record Ports.

Auto Detect is on. TestCafe Studio automatically selects suitable open ports.

Proxy URL

The proxy server that routes network requests. The value can include authentication credentials. Examples: proxy.mycorp.com, 172.0.10.10:8080, username:password@proxy.mycorp.com.

 

Bypass proxy for

You may need to bypass the proxy to gain access to some resources — including local resources. Add these resource URLs to the Bypass proxy for field. Separate the list of URLs with a comma - do not add spaces. Use the * wildcard to indicate variable URL parts. For example, localhost:8080 or *.mycorp.com. You can omit wildcards at the beginning and end of the URL: *.mycorp.com and .mycorp.com have the same effect.

 

Note

Your Run Ports should not match your Record Ports. Otherwise, you may not be able to record tests and run tests at the same time.

SSL Settings

SSL Settings come in effect when TestCafe serves test pages over HTTPS.

Options

Description

Default

Use SSL

Serves pages over HTTPS.

Off

Custom Certificate

Encrypts HTTPS connections with a custom SSL certificate. If this option is disabled, TestCafe uses the built-in self-signed certificate. Note that most browsers do not accept self-signed certificates without extra configuration.

Off

Certificate

The file that contains the custom certificate.

 

Private Key

The private key of the Certificate holder.

 

Retry Test Pages

Enable the Retry Test Pages option to retry failing page requests. The maximum number of attempts is 10. This capability requires a secure connection since it makes use of Service Workers. Enable HTTPS or set hostname to localhost.

HTTP Settings

Turn the Disable HTTP\2 option on to disable support for HTTP\2 requests.

Appearance

The Appearance menu allows you to switch between UI themes.

TestCafe Studio includes two UI themes: Light and Dark. The System default option automatically matches the operating system theme.

Data Sharing

Select the Join the Customer Experience and Notification Program checkbox to send usage statistics and crash reports to DevExpress. You can opt out at any time.