testcafe-browser-provider-android

This is the android browser provider plugin for TestCafe.

Supported Browsers

NOTE: This plugin resets Chrome to a freshly installed state on each test.

HELP NEEDED: Maybe someone finds a way to start Chrome in private/incognito mode instead. (See Issue #4)

Firefox is started in private mode.

In order to communicate with the device, the Android Debug Bridge is required. If you dont want to install Android Studio, the standalone package can be downloaded on https://developer.android.com/studio/releases/platform-tools.html.

Note that the adb command needs to be available on the commandline. (You may need to put it in your PATH enviornment variable.)

Googles guide "Get Started with Remote Debugging Android Devices" guides through the basics of hardware setup, and how to use Chromes Developer Tools on remote devices. (Handy once you found problems that only occur in mobile devices. See also: "Debugging Firefox for Android over USB").

Build has dependencies

npm install -g gulp 
npm install -g testcafe
npm install
gulp build
npm link

Once that is done - you run it by running a test in testcafe, or commands in testcafe.

This command lists all android devices locally

testcafe -b android

This command runs a sample test on an attached android device.

testcafe android exampletests/test.js

npm install testcafe-browser-provider-android

You can determine the available browser aliases by running

testcafe -b android

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

testcafe android:browser1 '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('android:browser1')
    .run();