Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Grunt task for running mocha specs in a headless browser (PhantomJS)
JavaScript HTML CSS

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
example
tasks
.gitignore
HISTORY.md
LICENSE-MIT
README.md
package.json

README.md

Automatically run client-side mocha specs via grunt/mocha/PhantomJS

grunt-mocha

(package/README format heavily borrowed from grunt-jasmine-task and builtin QUnit task)

Grunt plugin for running Mocha browser specs in a headless browser (PhantomJS)

Getting Started

Important note

If you are not using AMD, include mocha-helper.js from tasks/mocha after you include mocha.js and run mocha.setup. The helper will override mocha.setup if it detects PhantomJS.

See the example folder for a vanilla example.

Example setup with AMD (advanced): https://gist.github.com/2655876

Grunt and this plugin

First, make sure you have grunt installed globally, npm install grunt -g

Install this grunt plugin next to your project's grunt.js gruntfile with: npm install grunt-mocha

Then add this line to your project's grunt.js gruntfile at the bottom:

grunt.loadNpmTasks('grunt-mocha');

Also add this to the grunt.initConfig object in the same file:

mocha: {
  index: ['specs/index.html']
},

Replace specs/index.html with the location of your mocha spec running html file.

Now you can run the mocha task with grunt mocha, but it won't work. That's because you need...

PhantomJS

This task is for running Mocha tests in a headless browser, PhantomJS. See the FAQ on how to install PhantomJS.

Mocha

Use Mocha

If you are not using AMD, include mocha-helper.js from tasks/mocha after you include mocha.js and run mocha.setup. The helper will override mocha.setup if it detects PhantomJS.

See the example folder for a vanilla example.

Example setup with AMD (advanced): https://gist.github.com/2655876

Maybe Growl?

Growl support is optional. I'm not sure what the Windows situation is with growl.

Hacks

The PhantomJS -> Grunt superdimensional conduit uses alert. If you have disabled or aliased alert in your app, this won't work. I have conveniently set a global PHANTOMJS on window so you can conditionally override alert in your app.

License

Copyright (c) 2012 Kelly Miyashiro Licensed under the MIT license.

Something went wrong with that request. Please try again.