node package manager
We need your input. Help make JavaScript better: Take the 2017 JavaScript Ecosystem survey »



"small test" for node

A small test runner for a simple, small test framework. Because, hey, everyone writes a test framework in node, right?

Really, I just wanted to see what I could do in a day or two. I'm currently using it in node-ravendb for two reasons:

  1. vows was not catching non-AssertionError errors in the code
  2. I didn't want to use anything very big--I don't have that many tests


Keep things small (the main testino module is around 300 lines of code) and simple, support the assert module. Other than that, a few simple things:

  1. Each test fixture is created using testino.createFixture and then adding a tests member to that object
  2. You simply add a tests object as a member of the fixture, and each function is considered a test case
  3. Each test module should export the test fixture as it's module.exports and optionally consider adding a code snippet to run the tests if the file is run directly

Bonus: Since this is JavaScript, tests members can have a name that is a string, not just a legal function name, so have fun with spec-style test names!

These points are demonstrated in the Usage section below.


var testino = require('testino');
var assert = require('assert');
module.exports = sampleTester = testino.createFixture('Sample Tester');
sampleTester.tests = {
  thingsAreWiredUp: function() {
    assert.ok(true, 'just making sure things are wired up');
  'we can use string names for methods too!': function() {
    assert.ok(true, 'see, this is easy!');
  thisTestShouldFail: function() {
    var actual = expected = null;, expected, 'this test failed on purpsose');
  'tests with unexpected errors end up in the "Other" category': function () {
    throw new Error("This result should end up in the Other category");
// If the file is run directly, just run the test fixture with default output 
if (require.main === module) console.log(;

and the output is:

$ node sample-test.js
TEST RESULTS FOR Sample Tester    Total: 4
    Passed: 2    Failed: 1    Other (unknown): 1
  FAILED test details:
        thisTestShouldFail              AssertionError: this test failed on purpsose
  OTHER test details:
        tests with unexpected errors end up in the "Other" category             Error: This result should end up in the Other category

© 2013 Tony Heupel