Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Drive in-browser tests with WD.
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib Now runs against on demand and with distant content.
package.json Fixed githun link in package.json + bumped for that.


Drive in-browser tests with WD.js.

Make sure you are running the latest node version


npm install wd-unit



Running a test!

Start by importing the required library.

var launcher = require('wd-unit');

Then you can go ahead and launch your test by running the launcher{
    runner: 'qunit',
    page: 'testpage.html',
    root: process.argv[1].slice(0, process.argv[1].lastIndexOf('/')),

Possible options are :

  • runner: Unit testing framework.
  • desired: Desired capabilities for the browser running the test.
    • Default: {browserName: 'firefox'}
  • addr: Base url with wich WD.js will work.
    • Default: 'localhost'
  • page: Test are run from this page.
    • Default: Document root.
  • root: Document root for the webserver.
    • Default: '.'
  • wd_args: Arguments to be passes to WD.js. Check out WD.js docs for more info.
    • Default: {}

Local vs. Distant content

  • Your unit test can be hosted on a distant webserver, in which case wd-unit will work with the webserver.
  • You can also work on loacl non hosted files, in this case wd-unit will run a very lightweight webserver which wd-unit will use to run tests. This webserver uses the root argument for finding content.

Currently supported frameworks

Take a look at our examples

Want more frameworks ?

Check out the wiki about writting plugins.

Something went wrong with that request. Please try again.