Skip to content
A Cucumber.js runner for browsers
JavaScript
Pull request Compare This branch is 13 commits behind jbpros:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
public/cukestall
views
.gitignore
README.md
cukestall.js
package.json

README.md

CukeStall

DISCLAIMER This project is at its experimental stage. It's not tested and might be buggy.

A Cucumber.js runner for browsers Node.js middleware.

CukeStall lets you run a Cucumber feature suite against a Node.js web application right from your web browser.

Usage

Plug CukeStall connect middleware into your app to serve it to the browser:

var connect   = require('connect');
var CukeStall = require('cukestall');

var app = connect();
app.use(connect.logger('test'));
// your app code goes here ...

app.use(CukeStall.runner({
  featurePaths: [__dirname + '/features/my.feature'],
  stepDefsPaths: [__dirname + '/features/step_definitions/stepdefs.js'],
  supportCodePaths: [__dirname + '/features/support/cukestall.js']
}));

app.listen(1337);

Your application is now running normally at localhost:1337 and CukeStall is reachable on localhost:1337/cukestall.

Backdoors

It is common to perform "short-circuit" actions from within step definitions and hooks. For example, you might need to wipe out the whole database before every scenario. To do so, you can use backdoors.

Backdoors are routes added on top of your existing application.

app.use(CukeStall.runner({
  featurePaths: [__dirname + '/features/my.feature'],
  stepDefsPaths: [__dirname + '/features/step_definitions/stepdefs.js'],
  supportCodePaths: [__dirname + '/features/support/cukestall.js']
  backdoors: {
    reset_all: function (req, res, next) {
      // this backdoor will allow a step definition on the browser side
      // to empty the database:
      MyDb.dropAll();
      res.end("DB emptied.");
    }
  }
}));

The backdoor can be triggered by POSTing to localhost:1337/cukestall/reset_all:

// features/support/cukestall.js

this.Before(function (callback) {
  $.post('/cukestall/reset_all', null, function (results, textStatus, jqXHR) {
    callback();
  });
});
Something went wrong with that request. Please try again.