dispatch:mocha-phantomjs

A Mocha test driver package for Meteor 1.3. This package reports server and client results in the server console and can be used for running tests on a CI server. This achieves what spacejam does but without the need for a separate Node package.

This package runs your client tests within a PhantomJS page. If you prefer a different solution, it should be possible to fork this package to make a variation that runs in Chrome or any other headless browser. If you do so, we can add a link to your package here.

Installation

In a Meteor 1.3+ app directory:

meteor add dispatch:mocha-phantomjs

Run app unit tests

meteor test --once --driver-package dispatch:mocha-phantomjs

Run app unit tests in watch mode

TEST_WATCH=1 meteor test --driver-package dispatch:mocha-phantomjs

Run with a different server reporter

The default Mocha reporter for server tests is the "spec" reporter. You can set the SERVER_TEST_REPORTER environment variable to change it.

SERVER_TEST_REPORTER="dot" meteor test --once --driver-package dispatch:mocha-phantomjs

Run with a different client reporter

This package includes a browser console reporter. You can set the CLIENT_TEST_REPORTER environment variable to the name of a different Node module to provide your own browser console reporter. You might want to do this if you don't like the indentation, spacing, formatting, etc. of the built-in reporter.

CLIENT_TEST_REPORTER="my-browser-console-reporter" meteor test --once --driver-package dispatch:mocha-phantomjs

When creating your custom console reporter, you can use the browserConsoleReporter.js file in this repo as your starting point.

NPM Scripts

A good best practice is to define these commands as run scripts in your app's package.json file. For example:

1"scripts": {
2  "test": "meteor test --once --driver-package dispatch:mocha-phantomjs",
3  "test:watch": "TEST_WATCH=1 meteor test --driver-package dispatch:mocha-phantomjs",
4  "start": "meteor run"
5}

And then run npm test for one-time/CI mode or npm run test:watch to rerun the tests whenever you change a file.