bridge.js

/*
 * Is injected into the spec runner file

 * Copyright (c) 2012 Kelly Miyashiro
 * Copyright (c) 2012 "Cowboy" Ben Alman
 * Licensed under the MIT license.
 * http://benalman.com/about/license/
 */

/*global mocha:true, alert:true, window:true */

(function() {
  var MOCHA_EVENTS = [
    'start',
    'test',
    'test end',
    'suite',
    'suite end',
    'fail',
    'pass',
    'pending',
    'end'
  ];

  // Send messages to the parent phantom.js process via alert! Good times!!
  function sendMessage() {
    var cache = [];
    var args = [].slice.call(arguments);

    // Safe stringifying of cyclical JSON
    function decycle(key, val) {
      if (typeof val === 'object' && val !== null) {
        if (cache.indexOf(val) >= 0) return;
        cache.push(val);
      }
      return val;
    }

    alert(JSON.stringify(args, decycle));
  }

  // Create a listener who'll bubble events from PhantomJS to Grunt
  function createGruntListener(ev, runner) {
    runner.on(ev, function(test, err) {
      var data = {
        err: err
      };

      if (test) {
        data.title = test.title;
        data.fullTitle = test.fullTitle();
        data.state = test.state;
        data.duration = test.duration;
        data.slow = test.slow;
        data.pending = test.isPending();
      }

      sendMessage('mocha.' + ev, data);
    });
  }

  // 1.4.2 moved reporters to Mocha instead of mocha
  var mochaInstance = window.Mocha || window.mocha;

  var GruntReporter = function(runner){
    if (!mochaInstance) {
      throw new Error('Mocha was not found, make sure you include Mocha in your HTML spec file.');
    }

    // Setup HTML reporter to output data on the screen
    mochaInstance.reporters.HTML.call(this, runner);

    // Create a Grunt listener for each Mocha events
    for (var i = 0; i < MOCHA_EVENTS.length; i++) {
      createGruntListener(MOCHA_EVENTS[i], runner);
    }

  };

  var Klass = function () {};
  Klass.prototype = mochaInstance.reporters.HTML.prototype;
  GruntReporter.prototype = new Klass();

  var options = window.PHANTOMJS;

  // Default mocha options
  var config = {
    ui: 'bdd',
    ignoreLeaks: true,
    reporter: GruntReporter
  };

  // If options is a string, assume it is to set the UI (bdd/tdd etc)
  if (typeof options === 'string') {
    config.ui = options;
  }

  // Extend defaults with passed options
  if (typeof options === 'object' && options !== null) {
    for (var key in options.mocha) {
      config[key] = options.mocha[key];
    }
  }

  mocha.setup(config);

  // task option `run`, automatically runs mocha for grunt only
  if (options && options.run) {
    mocha.run();
  }
}());