Installation

uitest can be installed on most Linuxes, OSX and Windows.

Prerequisites

• Node.js 0.8.0 or greater. Installation instructions can be found here

Installing from npm

Installation can be installed by:

$ npm i -g uitest

Installing from git

Installation can be achieved using git. The code is mainly hosted on Github.

From the master branch

$ git clone git://github.com/uitest/uitest.git
$ cd uitest
$ ln -sf `pwd`/bin/uitest /usr/local/bin/uitest
$ npm install

Once uitest install on your machine,you should obtain something like this:

$ node -v
v0.10.11
$ uitest --version
0.4.1
# ...

Initialize uitest

Now we should tell uitest which browser can be used and other options see also config:

$ uitest init

Warning

In Linuxes and MAC OS ,you should use sudo , so uitest can create the file

What did we just do?

1. we created a new file uitest.conf.js
2. save your configs in the file

Install browsers plugin

We use browsers plugins to inject our own scripts to the browser,and the script locates at {uitestDir}/static/uitest.js

$ uitest plugin

Use it to auto-install your plugins,there may be are some issues,you can find the plugin under {uitestDir/plugin},you can install them yourself;

The chrome plugin can be downloaded here:chrome store

uitest on Windows

Browsers Initialize additions

We had met some issue on Windows , one was the PATH, here is the solution:

• Append ";C:\Program Files\Google\Chrome\Application\chrome.exe" to your PATH environment variable.
• Modify this path appropriately if you installed your browsers to a different location.

Warning

if you run the command:uitest init and press tab to select the browsers you wanner choose,and press enter.(you can choose muti-browsers)

if you see the warning :

No binary for [your browser]

then you need to set your PATH

Known Bugs & Limitations

• Due to its asynchronous nature, uitest doesn’t work well with Firefox we are trying to resolve it.