min-wd

Minimal WebDriver that pipes stdin to browsers

npm install min-wd
1 downloads in the last day
4 downloads in the last week
71 downloads in the last month

Minimal WebDriver

Pipes stdin to all configured browsers using the Selenium WebDriver protocol.

  • Concurrent test runs
  • SauceLabs support
  • No web server required

Repository: https://github.com/mantoni/min-webdriver


Install with npm

npm install min-wd -g

Usage

Put a config file name .min-wd in your project directory:

{
  "hostname": "localhost",
  "port": 4444,
  "browsers": [{
    "name": "internet explorer",
    "version": "10"
  }, {
    "name": "chrome"
  }]
}

Alternatively, add a webdriver property with the configs to your package.json file.

Assuming my-script.js contains this:

console.log('Hello %s!', 'browser');
process.exit(0);

Use with browserify:

$ browserify -t min-wd my-script.js | min-wd
= internet explorer 9 ========================================================
Hello browser!
= chrome * ===================================================================
Hello browser!

SauceLabs

Export your SauceLabs credentials:

export SAUCE_USERNAME="your-user-name"
export SAUCE_ACCESS_KEY="your-access-key"

Enable SauceLabs in your .min-wd file:

{
  "sauceLabs": true,
  "browsers": [...]
}

Loading a web page

By default, min-webdriver will folk a new browser and inject the given script straight away without loading any web page. If you want to run your test cases in the context of a web page, you can configure the start page in the .min-wd file:

{
  "url": "http://my-test-page"
}

Mocha Support

Testing with Mocha requires mocaccino:

$ browserify -t min-wd my-test.js | mocaccino -b -r list | min-wd

If this is your use case, make sure to give Mochify a try.

Timeouts

The default timeout for the log polling script is 10 seconds. If you have long running test cases that don't print anything for more than 10 seconds, you can increase the timeout by adding a timeout property to your config:

"timeout": 20000

IE trouble shooting

If IE 9 reports it can't find JSON, then the Selenium default page makes IE switch to quirks mode. Work around this by loading a simple web page for IE:

{
  "browsers": [{
    "name": "Internet Explorer",
    "version": "9",
    "url": "http://my-server/doctype.html"
  }]
}

With this content in the doctype.html:

<!DOCTYPE html><html><head><meta encoding="utf-8"></head><body></body></html>

License

MIT

npm loves you