node-qunit is a specialized test runner designed to integrate the QUnit testing framework with Node.js environments. Currently at version 2.0.2, this package was last published seven years ago and is now considered abandoned. It differentiates itself by running each test file in its own spawned Node.js process, enabling parallel execution for improved performance. It offers both a command-line interface (CLI) and a programmatic API for integrating with build systems. While providing test coverage via Istanbul, its core value proposition was maintaining API compatibility with the browser-based QUnit, allowing for consistent test writing across client and server environments. It aimed for a simplified API, particularly for asynchronous testing, and supported both TDD and BDD styles. Given its abandonment, users should exercise caution or consider more modern alternatives.
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslnode 18–226 runs
build_error
glibcnode 18–226 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
This package is CommonJS-only. Its last update was 7 years ago, pre-dating widespread Node.js ESM support.
const testrunner = require("node-qunit");
`QUnit` is exposed as a global object within the test files executed by `node-qunit`. The `module` keyword is reserved in Node.js, so `QUnit.module` must be used instead.
QUnit.module('My tests', function() { /* ... */ });
`QUnit.test` is also exposed globally to test files, following the standard QUnit API for defining test cases.
QUnit.test('My test case', function(assert) { /* ... */ });
Demonstrates how to programmatically run QUnit tests in Node.js, including setting up a simple code file and its corresponding test file using the `node-qunit` test runner API. This example creates temporary files to illustrate the `code` and `tests` configuration.
const testrunner = require("node-qunit");
const path = require("path");
const fs = require("fs");
// Define a simple code file to be tested
const codeFilePath = path.join(__dirname, "my-code.js");
fs.writeFileSync(codeFilePath, `
module.exports = {
add: (a, b) => a + b,
subtract: (a, b) => a - b
};
`);
// Define a simple test file using QUnit API
const testFilePath = path.join(__dirname, "my-tests.js");
fs.writeFileSync(testFilePath, `
QUnit.module('Calculator', function(hooks) {
hooks.beforeEach(function(assert) {
// Setup code if needed
});
QUnit.test('add function', function(assert) {
const calculator = require('./my-code.js'); // Relative path needed for child process
assert.equal(calculator.add(1, 2), 3, '1 + 2 should be 3');
});
QUnit.test('subtract function', function(assert) {
const calculator = require('./my-code.js');
assert.equal(calculator.subtract(5, 2), 3, '5 - 2 should be 3');
});
});
`);
// Configure and run the tests
testrunner.run({
code: codeFilePath,
tests: testFilePath,
log: {
summary: true,
errors: true,
coverage: false // Assuming no istanbul setup for quickstart
}
}, function(err, report) {
if (err) {
console.error("Test runner encountered an error:", err);
process.exit(1);
}
console.log("Test Report:", JSON.stringify(report, null, 2));
// Cleanup generated files
fs.unlinkSync(codeFilePath);
fs.unlinkSync(testFilePath);
process.exit(report.globalSummary.failed > 0 ? 1 : 0);
});
qunit --version
Upgrade
Version history
Breaking-change detection hasn't run for this library yet.
Audit
Security & dependencies
CVE tracking and dependency tree are planned for a later release.