No fancy crap, just testing like a man.

npm install testjs
31 downloads in the last week
66 downloads in the last month


Prints nothing else than the information you actually need and does nothing more than wrapping node's assert module.

  • Small footprint, minimal dependencies
  • Non-utf8 and Windows terminal approved
  • Allows asynchronous testing
  • Allows modular tests by just assembling data structures
  • API and Cli (just testjs)
  • Available through npm: npm -g install testjs




Place your test suite in tests/suite.js.

// package.json
    "devDependencies": {
        "testjs": "latest"
    "scripts": {
        "test": "testjs"

npm test


// tests/run.js
var Suite = require("testjs");

    "firsttest": function(test) {
// package.json
    "scripts": {
        "test": "node tests/run.js"

npm test


All of node's assert (just replace assert through test) plus test.notOk(...) as a negated ok.

  • test#ok(actual) / test#notOk(actual) / test#ifError(actual)
  • test#equal(actual, expected) / test#notEqual(actual, notExpected)
  • test#deepEqual(actual, expected) / test#notDeepEqual(actual, notExpected)
  • test#strictEqual(actual, expected) / test#notStrictEqual(actual, notExpected)
  • test#throws(blockFunction[, classRegExpOrValidationFunction]) / test#doesNotThrow(blockFunction)

There is also a test#log(...) for logging straight to the test console.

Self-explaining examples

When typing testjs in a terminal, tests/suite.js will be run. Also supports running runners: testjs tests/run.js or custom / other unit tests under the condition that the runner (here: run.js) does not export anything. If it does, whatever it exports will be run.


test.js is partially interoperable with nodeunit. There is no setUp/tearDown however and there are no aliases for things like equal, which is for example aliased as equals in nodeunit.

test.js including dependencies is about 100kb while nodeunit is about 16mb.

Command line options

Option Function
--nocolors or -nc Disables terminal colors.
--name=NAME or -n=NAME Sets the suite name. Defaults to the name defined in package.json which is looked up inside of the current working directory or to the base name of the suite file if there is no package.json. The hard coded default is suite.
--silent or -s Does not produce any output.

Always returns the number of failed tests as the status code.

Example: testjs --name=MyGame -nc tests/mygame-test.js


Apache License, Version 2.0

npm loves you