Framework for writing tests once and running them under any test engine.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Framework for writing tests once and running them under any test engine.

Currently, we only support conversion from Vows to Mocha. However, support for more frameworks is planned in the future.

Getting Started

Download crossbones.

In your web page:

<script src="crossbones.js"></script>
// Create a new test suite
var suite = new Skeleton('Sauron.js');

// Add in a test batch -- this is for a global mediator
  'Sauron': {
    'can emit events': function () {
    'can set up functions to subscribe to events': function () {
      var works = false;
      Sauron.on('basicOn', function () {
        works = true;
    'can unsubscribe functions from events': function () {
      var count = 0;
      function basicOff() {
        count += 1;

      Sauron.on('basicOff', basicOff);
      Sauron.voice('basicOff');'basicOff', basicOff);
      assert(count === 1);

// Export the suite to mocha

// and run it
var runner =;


Skeleton exposes a constructor function to the window scope.

 * Constructor for a Skeleton (test suite)
 * @param {String} name Name to call this test suite (may not apply to all BDD)

Test suites have the methods of addBatchwhich is heavily based off of vows

 * Method to add test batches to this test suite
 * @param {Object} batch Batch of tests to add to this test suite
 * @param {Object} batch.* Context containing a set of tests to run
 * @param {Function} batch.*.topic Topic function which takes the place of 'describe' in Mocha and 'topic' in Vows
 * @param {Function} batch.*.* Function that will run a test on the current topic
 * @param {String} batch.*.* Placeholder for a test that will be created later. These will be skipped for test suites that don't support them
 * @returns {this} Skeleton test suite that is being worked on

and exportTo.

 * Run method for a test suite (currently only supporting Mocha)
 * @param {Function|String} engineName If a function, Skeleton will process via it. Otherwise, Skeleton will retrieve the engine from its modules.
 * @returns {Mixed} Returns result of engine

New test engines can be added via Skeleton.addModule(name, fn).

If a function is asynchronous, it must have an asynchronous flag set on it (fn.SKELETON_ASYNC = true;). Skeleton.async is a helper method that will set this flag for you:

var myAsyncFn = Skeleton.async(function () {
  return 1;
myAsyncFn.SKELETON_ASYNC; // true


In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint your code via grunt.

Testing is currently done manually. You must serve the files locally (I suggest npm install -g serve && serve). Then, you can test Skeleton and its module tests respectively. Test results should be viewed via the console.


Copyright (c) 2013 Ensighten Licensed under the MIT license.