This plugin integrates TestCafe with the TestingBot Testing Cloud.

Install

npm install testcafe-browser-provider-testingbot

Prerequisites

You need to have NodeJS installed and Java (JRE8 or higher). Java is required for the TestingBot Tunnel to work.

Usage

Before you can use this plugin, you will need to get the TestingBot key and secret from the TestingBot member area. Once you have these two credentials, add these as environment variablesTB_KEY and TB_SECRET.

You can determine the available browser aliases by running

testcafe -b testingbot

When you run tests from the command line, use the alias when specifying browsers:

testcafe "testingbot:chrome@latest:WIN10" 'path/to/test/file.js'

If you'd like to run a test on multiple browsers, simultaneously:

testcafe "testingbot:chrome@latest:WIN10","testingbot:firefox@latest-1:SONOMA" 'path/to/test/file.js'

When you use API, pass the alias to the browsers() method:

testCafe
    .createRunner()
    .src('path/to/test/file.js')
    .browsers('testingbot:chrome@83:WIN10')
    .run();

Configuration

Use the following environment variables to set additional configuration options:

• TB_TEST_NAME - the text that will be displayed as Test Name on TestingBot.

• TB_BUILD - the text that will be displayed as Build Name on TestingBot.

• SELENIUM_CAPABILITIES - path to a file which contains a JSON formatted object with the capabilities you want to use.

• TB_CI_MODE - set this variable to 1 when you are using this plugin in a CI context with a TestingBot CI plugin.

• TB_SCREEN_RESOLUTION - allows setting the screen resolution for desktop browsers in the ${width}x${height} format, has no effect when specified for a mobile browser.

• SELENIUM_HEARTBEAT - this plugin will by default send a heartbeat every 8 seconds, to keep the WebDriver session open. Use this variable to change this interval.

Example:

export TB_SCREEN_RESOLUTION="1920x1080"
export TB_TEST_NAME="E2E TestCafe"
export TB_BUILD="Build 42"
testcafe testingbot:safari,testingbot:chrome tests/

Selenium Capabilities file

You can use a capabilities.json file which contains a JSON object with capabilities you want to use. Each key in this json file can be used as a parameter. For example, if you have a chrome key in this file, then the following command will send the capabilities for this key to the TestingBot grid:

testcafe testingbot:chrome tests/

Build Plugin Locally (Development Mode)

1. Clone this repository
2. Install Packages and Test/Build

$ npm i
$ npm run test

3. Link Testcafe with this plugin

$ sudo npm link

About TestingBot

TestingBot provides a cloud of +5200 browsers and physical mobile devices. TestingBot is 100% compatible with all frameworks and Selenium/Appium bindings. Take advantage of high concurrency selenium testing in the cloud.