roombajs

Javascript integration/functional testing

npm install roombajs
11 downloads in the last week
44 downloads in the last month

roomba

Not really ready for prime time. Works well for us

Automated javascript testing. Esp for phonegap applications where you need to bundle integration tests with the app and test on an actual device.

Dependencies

  • Only npm support at this point. So you'll need something like browserify to bundle it into the browser.
  • requires jQuery

Has two components.

  • Server: a reporting server where test run information is logged
  • lib/roomba.js is the runner code that needs to be bundled with the js app

Install

npm install roombajs

Server

Start the server using

node app.js 
//or
npm start

Roombajs client library

Create an instance of roomba for each run. This creates a unique run id, used to submit reports to server

var Roomba = require("roomba"),
var roomba = new Roomba(serverUrl, nameOfTest);

Now use the various methods to say what all you need to do

roomba.tap("#foo div");
roomba.waitFor(300);
roomba.tap("#bar span");

Add your asserts at any point. You can use any assert library, here I use chai.

roomba.then(function() {
    expect($(".uiPageActive .subToolBar em").html()).to.contain.string("Philadelphia to SF");
});

Signal that you are done specifying your tests

roomba.runAll(); //Runs each step one by one, and submits the report to server

API reference

Constructor

var roomba = new Roomba(roombaSeverUrl, nameOfTest);
//example
var roomba = new Roomba("http://localhost:5000", "regression suite");

Methods

Tap

roomba.tap(jQuerySelector);
//example
roomba.tap("#foo");

fill a textbox or text input

roomba.fill(selector, value);
//example
roomba.fill("#loginUsername", "a@b.com");

select a drop down

roomba.select(selector, value);
//example
roomba.select("#environment", "production");

start/then: execute arbitrary piece of javascript at that time. Useful to add asserts. start and then are equivalent, just syntax sugar to indicate start of a test.

roomba.start(function)
roomba.then(function)
//example
roomba.start(function(){
    expect($("#foo").val()).to.be(500);
});

waitFor: timeout or function

roomba.waitFor(timeMilliSeconds);
roomba.waitFor(fn)
fn: return true to indicate waitFor condition is met
//example
roomba.waitFor(300);
roomba.waitFor(function(){
    return ($("#foo").length === 1);
})

runAll: Signal that you are done specifying the test. Now run actions one by one. On each step, information will be logged in roomba server. If there is an error in any step, it'll bail out.

roomba.runAll()

module: Indicate start of a module. Once a module is set, any actions done like a tap are logged under that module. If none specified, all tests go into 'default' module. Module names should be unique, or reports will get messed up.

roomba.module(moduleName)
//example
roomba.module("login module")
npm loves you