General Questions

I have heard that TestCafe does not use Selenium. How does it operate?

Unlike most testing solutions, TestCafe is not built on Selenium. This allows us to implement features you cannot find in Selenium-based tools (for example, testing on mobile devices, user roles, automatic waiting, etc.).

TestCafe uses a URL-rewriting proxy which allows it to work without the WebDriver. This proxy injects the driver script that emulates user actions into the tested page.

You can read about this in our forum. Feel free to ask for more details.

What is the difference between TestCafe Studio and open-source TestCafe?

  TestCafe TestCafe Studio
No need for WebDriver, browser plugins or other tools
Cross-platform and cross-browser out of the box
Write tests in the latest JavaScript or TypeScript
Clear and flexible API supports ES6 and PageModel pattern
Stable tests due to the Smart Assertion Query Mechanism
Tests run fast due to intelligent Automatic Waiting Mechanism and Concurrent Test Execution
Custom reporter plugins
Use third-party Node.js modules in test scripts
Integration with popular CI systems  ✓*
Free and open-source **
Visual Test Recorder  
Interactive Test Editor  
Automatic Selector Generation  
Run Configuration Manager  
IDE-like GUI  

* You can use open-source TestCafe to run TestCafe Studio tests in CI systems.
** TestCafe Studio is currently available as a free preview version. After the official release, it will require a paid license. TestCafe Studio is proprietary.

Has TestCafe v2015.1 been deprecated?

TestCafe v2015.1 is no longer available for purchase or subscription renewal. We recommend that TestCafe v2015.1 users switch to TestCafe Studio to access the latest features. See this blog post for details.

Which browsers does TestCafe support? What are the exact supported versions?

You can find a list of supported browsers in our documentation. TestCafe is tested against the two latest versions of each browser except for the browsers whose versions are specified explicitly in this list.

We do not use the most recent JavaScript features in TestCafe code, which means it should work with any browser with HTML5 support released in the last three years.

Can I use third-party modules in tests?

You can import third-party modules to test files in the same way as a regular node.js module.

On the server side, use the import statement.

import fs from 'fs';

fixture `fixture`

test('test', async t => {
   var filePath = 'filepath.js';

   await t.expect(fs.existsSync(filePath)).ok();

On the client side, use t.eval to include the desired module in the test. Then you can use this module inside client functions and selectors.

test('test', async t => {
    // eval jquery code to add jQuery to the page
    await t.eval(new Function(fs.readFileSync('./jquery.js').toString()));

    var clientFunction = ClientFunction(() => {
        // You can use $ here
        return $('div').text();

    var text = await clientFunction();

How do I work with configuration files and environment variables?

TestCafe works without any configuration. It does not have any config files where you can place custom variables. However, you can introduce your own configuration file and import it to the test code.

For example, you need to pass a website's base URL to test code. In this instance, you can create the following config.json file:

    "baseUrl": "http://localhost/testcafe"

In the test code, import it as you would do with a regular JavaScript module.

import config from './config';

fixture `Fixture`
    .page `${config.baseUrl}/test1/index.html`;

Alternatively, you can use custom command line parameters or environment variables.

The following command passes the env argument to the test code:

testcafe chrome test.js --env=development

In the test, use an argument parser library (like minimist) to parse custom arguments.

import minimist from 'minimist';

const args = minimist(process.argv.slice(2));
const environment = args.env;


test('check environment', async t => {
  console.log('Environment:', environment);

To set an environment variable use the following command on Windows.

set DEV_MODE=true
testcafe chrome test.js

On macOS, the workflow is longer.

In test code, you can access this variable as process.env.DEV_MODE.


I have installed TestCafe but I cannot run it. What should I do?

Check your firewall. First, make sure that your firewall does not block the ports TestCafe uses. TestCafe chooses free ports automatically by default. Use the --ports command line option or the createTestCafe API factory function to specify custom ports. After that, check that the firewall does not block these specific ports.

Check your proxy server. Another reason for this problem can be the proxy server you use to access the Internet. If your network is connected to the Web via a proxy, use the --proxy command line option or the useProxy API method to specify the proxy address.

For Linux check X11. Also note that if you run TestCafe on Linux, you need to make sure the system is running the X11 server. Without X11, you can only run tests in cloud services and headless Google Chrome. However, if you use the Xvbf server, you can run any other browser in the headless mode.

When I run a TestCafe test, I get an unexpected error. What can cause that?

JavaScript errors. The most common reason for this is a JavaScript error on the tested page. Load this page in the browser, open the console and see if the page has any errors. In case there are errors, you can either fix them or use the --skip-js-errors flag to tell TestCafe to skip them.

Browser extensions. If this does not help, try running the problematic test in incognito mode. You can do this by adding an appropriate flag after the browser name.

testcafe "chrome -incognito" tests/test.js
testcafe "firefox –private-window" tests/test.js

If the test runs successfully, it might be browser extensions causing the issue. Try disabling them one by one and restart the test in the regular mode at each iteration. This way you can find out which extension prevents the test from running.

Third-party modules. In rare cases, third-party modules can be the cause. If you use a locally installed TestCafe, try installing it globally and running the test outside of the project to eliminate the influence of third-party modules.

I have installed TestCafe plugins but they do not work. What have I done wrong?

Plugins should also be installed locally if you are using a locally installed TestCafe.

npm install --save-dev {pluginName}

If you are going to use a global TestCafe installation, or you wish to use the plugin in other projects as well, install it globally.

npm install -g {pluginName}

My test fails because TestCafe could not find the required webpage element. Why does this happen?

This happens because either:

  • one of the selectors you used in test code does not match any DOM element, or
  • you have tried to specify an action's target element using a wrong CSS selector or a client-side function that returns no element.

To determine the cause of this issue, do the following:

  1. Look at the error message in the test run report to learn which selector has failed.
  2. Add the t.debug() method before this selector to stop test execution before it reaches this point.
  3. Run the test and wait until the browser stops at the breakpoint.

After this, use the browser's development tools to check that:

  • the element is present on the page;
  • the element is visible (TestCafe considers it visible if it does not have display set to none, visibility set to hidden or the zero width or height);
  • the element's part targeted by the action is visible (the center of the element by default; it can be changed using the offsetX and offsetY parameters);
  • the element is not in an <iframe> (if it is, use the t.switchToIframe method to switch to the appropriate <iframe>).

Also, try running the test at full screen. Use the t.maximizeWindow and t.resizeWindow actions to control the browser window size. If the test passes, it means your webpage hides the target element when the window is resized to smaller dimensions.

Finally, try updating TestCafe to the latest version to see if the problem persists.