JarCastingMocha QUnit UI
An interface for Mocha that implements QUnit's API.
Mocha ships with a QUnit interface, but it lacks assertions, support for expected assertion count, and the asyncTest method (among other things). This is an alternate implementation that fully supports the entire QUnit API. It may be run either in Node.js or the browser. The goal is to get as close as possible to being able to run QUnit tests unaltered in Mocha.
Installation
$ npm install mocha-qunit-ui --save-dev
Usage
Node.js
From the command line:
$ mocha --ui mocha-qunit-ui test/test-file-1.js
Programatically:
// Load mocha-qunit-ui
require("mocha-qunit-ui");
// Tell mocha to use the interface.
var mocha = new Mocha({
ui:"qunit"
});
// Add your test files
mocha.addFile("path/to/my/testfile.js");
// Run your tests
mocha.run(function(failures){
process.exit(failures);
});
Browser environments
Declare an HTML file with the following markup to run tests in the browser:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Tests</title>
<script src="path/to/mocha.js"></script>
<script src="mocha-qunit-ui.js"></script>
<script>
mocha.setup({
ui: "qunit"
});
</script>
<link rel="stylesheet" type="text/css" href="path/to/mocha.css">
</head>
<body>
<div id="mocha"></div>
<script>
module("On page test!");
test("An awesome QUnit style test", 2, function () {
ok(true);
equal(1, parseInt("1"));
});
mocha.run();
</script>
</body>
</html>
You can also use qunit-mocha-ui from Grunt with the grunt-mocha task. Here's an example Gruntfile.js:
module.exports = function(grunt) {
grunt.loadNpmTasks('grunt-mocha');
grunt.initConfig({
mocha: {
test:{
options:{
mocha: {
ui: 'qunit'
}
},
src: [
"test/test-file-1.js"
]
}
}
});
grunt.registerTask('default', ['mocha']);
};
Known differences from QUnit API
- The global variable
moduleis reserved in Node.js. If you want to define a QUnit module in that environment, use theQUnit.modulealias.
Running tests
- Install dependencies:
npm install - Update QUnit submodule
git submodule update --init --recursive npm test
You can run QUnit's test suite by opening test/qunit.html in a browser.
License
Copyright (c) 2013 Mike Pennisi
Licensed under the MIT license.