Skip to content
Run mocha tests in electron the easy way.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

mochatron (no longer maintained)


mochatron makes integration testing with mocha and electron easy.


  • Run tests in electron (fast & modern!) rather than phantomJS.
  • Ability to see test output in node AND the electron window console.
  • Option to silently fail on errors so that tests can be run in development with file watching and not stop on an error.
  • Option to show the electron window for easier debugging or hide it and run mocha tests headlessly.


Install it with npm and make sure you've installed electron-prebuilt globally as well.

npm install -g electron-prebuilt
npm install --save-dev mochatron


Use the script from the command line or node.

Note: by default the electron window isn't shown so that the test runs 'headless', but for debugging it can be helpful to see the window so in the config set 'window' to true or pass the '-w' argument.

node .\node_modules\mochatron -w http://localhost/
var mochatron = require('mochatron');

  url: 'http://localhost/',
  silent: false,
  window: false

I haven't gotten around to making plugins for gulp or grunt yet (Contributions is this area would be welcome) but in the meantime here is an example of how the script can be used from a gulp task.

var gulp = require('gulp');
var mochatron = require('mochatron');

gulp.task('test', function() {
    url: 'http://localhost/',
    silent: false,
    window: false

You also need to make sure you are including the mocha scripts on the page. If you have already been using mocha for browser testing then this step might already be done for you, but if you haven't, an example of the HTML code required to include mocha might look like this.

<div id="mocha"></div>
<link rel="stylesheet" href="/node_modules/mocha/mocha.css">
<script src="/node_modules/mocha/mocha.js"></script>
<script src="/node_modules/chai/chai.js"></script>

<script src="/test/test.js"></script>

  if (window.mochatron) {;
  } else {;

Note the call to mochatron AFTER mocha / chai and your test.js file.


Here's an example of how to call mochatron with all of its default options and comments about them.

  // Url to test.
  url: 'http://localhost/',
  // Silently swallow errors.
  silent: false,
  // Show window.
  window: false,

For command line usage this should give you an idea of what arguments can be passed.

var program = require('commander');

// Handle command line usage.
  .usage('[options] <url>')
  .option('-w, --window', 'Show window', false)
  .option('-s, --silent', 'Silently swallow errors', false)
node .\node_modules\mochatron -w -s http://localhost/


  • Tests



  • Publicly launched


Contributions and suggestions are welcome! Please feel free to open an issue if you run into a problem or have a feature request. I'll do my best to respond in a timely fashion.

If you want to open a pull request just fork the repo but please make sure all tests and lint pass first.



You can’t perform that action at this time.