What is qunit?
QUnit is a powerful, easy-to-use JavaScript unit testing framework. It is used to test any generic JavaScript code, including code running in the browser or in Node.js. QUnit is especially useful for testing jQuery projects.
What are qunit's main functionalities?
Basic Test
This feature allows you to write a basic test case. The `QUnit.test` function defines a test with a name and a callback function. The `assert.ok` method checks if the given expression is true.
QUnit.test('hello test', function(assert) {
assert.ok(1 == '1', 'Passed!');
});
Asynchronous Testing
QUnit supports asynchronous testing. You can use async/await to handle asynchronous operations within your tests. The test will wait for the promise to resolve before making assertions.
QUnit.test('asynchronous test: async and await', async function(assert) {
const result = await new Promise(resolve => setTimeout(() => resolve('done'), 1000));
assert.equal(result, 'done', 'Passed!');
});
Module Grouping
QUnit allows you to group related tests using `QUnit.module`. You can also define setup and teardown logic using hooks like `beforeEach` and `afterEach`.
QUnit.module('group a', function(hooks) {
hooks.beforeEach(function(assert) {
assert.ok(true, 'beforeEach called');
});
QUnit.test('a basic test example', function(assert) {
assert.ok(true, 'this test is fine');
});
});
Other packages similar to qunit
mocha
Mocha is a feature-rich JavaScript test framework running on Node.js and in the browser, making asynchronous testing simple and fun. Mocha tests run serially, allowing for flexible and accurate reporting, while mapping uncaught exceptions to the correct test cases. Compared to QUnit, Mocha is more flexible and can be paired with various assertion libraries like Chai.
jest
Jest is a delightful JavaScript Testing Framework with a focus on simplicity. It works out of the box for most JavaScript projects and provides a rich API for writing tests. Jest includes built-in assertion libraries and mocking capabilities, making it a more integrated solution compared to QUnit.
jasmine
Jasmine is a behavior-driven development framework for testing JavaScript code. It does not depend on any other JavaScript frameworks and does not require a DOM. Jasmine is known for its easy-to-read syntax and is often compared to QUnit for its simplicity and ease of use.
This is a port of QUnit unit testing framework to nodejs
http://github.com/jquery/qunit
Features
- the simplest API of the world :)
- 100% identical API for client and node (passing all unit tests from QUnit)
- simple asynchronous testing
- tests inside of one testfile run synchronous, but every testfile runs async
- tests from each file run in its own spawned node instance
- usage via CLI or testrunner
- uses the assert module
- test coverage via http://siliconforks.com/jscoverage
Installation
npm install qunit
API
http://docs.jquery.com/QUnit
Setup
// Add a test to run.
test( name, expected, test )
// Add an asynchronous test to run. The test must include a call to start().
asyncTest( name, expected, test )
// Specify how many assertions are expected to run within a test.
expect( amount );
// Separate tests into modules.
module( name, lifecycle )
Assertions
// A boolean assertion, equivalent to JUnit's assertTrue. Passes if the first argument is truthy.
ok( state, message )
// A comparison assertion, equivalent to JUnit's assertEquals. Uses "==".
equals( actual, expected, message )
// A comparison assertion. Uses "===".
strictEqual( actual, expected, message )
// A deep recursive comparison assertion, working on primitive types, arrays and objects.
same( actual, expected, message )
Asynchronous Testing
// Start running tests again after the testrunner was stopped.
start()
// Stop the testrunner to wait to async tests to run. Call start() to continue.
stop( timeout )
Usage
testrunner
var testrunner = require( "qunit" );
Defaults:
{
errorsOnly: false, // set it to true if you want to report only errors
errorStack: true, // set it to false if you want to get error stack in report
summary: true, // print a summary about all tested stuff after finish
coverage: true, // display coverage
paths: null // add paths to require of test environment
}
// to change any option - change it :)
testrunner.options.optionName = value;
// one code and tests file
testrunner.run({
code: "/path/to/your/code.js",
tests: "/path/to/your/tests.js"
});
// one code and multiple tests file
testrunner.run({
code: "/path/to/your/code.js",
tests: ["/path/to/your/tests.js", "/path/to/your/tests1.js"]
});
// array of code and test files
testrunner.run([
{
code: "/path/to/your/code.js",
tests: "/path/to/your/tests.js"
},
{
code: "/path/to/your/code.js",
tests: "/path/to/your/tests.js"
}
]);
// using testrunner callback
testrunner.run({
code: "/path/to/your/code.js",
tests: "/path/to/your/tests.js"
}, function( report ) {
console.dir(report);
});
// specify dependency
testrunner.run({
deps: "/path/to/your/dependency.js",
code: "/path/to/your/code.js",
tests: "/path/to/your/tests.js"
});
// specify multiple dependencies
testrunner.run({
deps: ["/path/to/your/dependency1.js", "/path/to/your/dependency2.js"],
code: "/path/to/your/code.js",
tests: "/path/to/your/tests.js"
});
Writing tests
QUnit API and code which have to be tested are already loaded and attached to the global context.
Because nodejs modules reserved "module" namespace we have to redefine it from QUnit namespace.
module = QUnit.module;
Basically QUnit API can ba accessed directly from global object or optional via "QUnit" object.
QUnit.test;
Some tests examples
test("a basic test example", function() {
ok( true, "this test is fine" );
var value = "hello";
equals( "hello", value, "We expect value to be hello" );
});
module("Module A");
test("first test within module", 1, function() {
ok( true, "all pass" );
});
test("second test within module", 2, function() {
ok( true, "all pass" );
});
module("Module B", {
setup: function() {
// do some initial stuff before every test for this module
},
teardown: function() {
// do some stuff after every test for this module
}
});
test("some other test", function() {
expect(2);
equals( true, false, "failing test" );
equals( true, true, "passing test" );
});
module("Module C", {
setup: function() {
// setup a shared environment for each test
this.options = {test: 123};
}
});
test("this test is using shared environment", 1, function() {
same( {test:123}, this.options, "passing test" );
});
asyncTest("this is an async test example", 2, function() {
setTimeout(function() {
ok(true, "finished async test");
strictEqual( true, true, "Strict equal assertion uses ===" );
start();
}, 100);
});
CLI
Some usage examples, read full cli api doc using "--help":
$ ./bin/cli --help
$ ./bin/cli -c ./code.js -t ./tests.js
$ ./bin/cli -c ./code.js -t ./tests.js -p /path/for/require /path1/for/require --cov false
Run tests
$ ./bin/testrunner
JSCoverage
Using JSCoverage 0.3.1 (from the ubuntu universe repositories) resulted
in a "jscoverage: unknown file type" error. Updating to the JSCoverage
0.5.1 from http://siliconforks.com/jscoverage/ resolves this issue.