To be the best unit test framework for node.js .

ChangeLog

v0.1.x

1. Replace setUp and tearDown with before(Each) and after(Each).
2. Setup before* and after* for a directory by adding a .js file with the same name.
3. The -dd/--debug option.
4. Only Node 4.x supported.

Installation

npm install -g bestunit.js

Run all tests

bu -h
bu -d /directory1/tests/placed -d /directory2/tests/placed
bu -f /the/test/case
bu -f /the/test/case -tc testCaseName

-f will be ignored if -d is given.

Promise

1. Simplest assertion style.
2. No more tests will be executed after assertion failed.
3. All after* functions of the failed TestCase and its TestGroup hierarchy will be called after assertion failed.
4. Feel free to save anything in the context and share then among all tests.

TestGroup and TestCase

BU only defines TestCase and TestGroup which includes TestCases. A TestGroup can be a javascript object or a directory.And it can be nested. You can define 4 methods for a TestGroup, which are before,after, beforeEach, afterEach. before/after will be called before/after running TestGroup. beforeEach/afterEach will be called before/after each TestCase/TestGroup in the TestGroup.

Assertion

You can require any assertion 3rd-party module you like or just use intrinsics.

Assertion

How to

Simplest

Touch a js source file looks like:

module.exports = {
	simpleCase1: function(t) {
		t.done();
	},
  simpleCase2: function(t) {
		t.done();
	},
};

DO NOT forget to call t.done() when the case is done.

t is an object and you can save anything into it to share them among all tests.

Nested

module.exports = {
	simpleCase1: function(t) {
		t.done();
	},

	testGroup1: {
		testGroup3: {
			tg3C1: function(t) {
				t.done();
			}
		},

		tg1Case1: function(t) {
			t.done();
		},
	},

	simpleCase2: function(t) {
		t.done();
	},

	testGroup2: {
		tg2Case1: function(t) {
			t.done();
		},
	},
};

With SetUps and TearDowns

module.exports = {
	before: function(t) {
    // Be called before any tests and beforeEach.
		t.done();
	},
	after: function(t) {
    // Be called after all tests and afterEach.
		t.done();
	},
	beforeEach: function(t) {
    // Be called before running g1, t and t2
		t.done();
	},
	afterEach: function(t) {
    // Be called after running g1, t and t2
		t.done();
	},
	g1: {
		t: function(t) {
			t.done();
		},
		t2: function(t) {
			t.done();
		}
	},
	t: function(t) {
		t.done();
	},
	t2: function(t) {
		t.done();
	}
};

Directory

Example

before* and after* of case.js will be applied to TestGroup defined by directory case.

Example

Example1

Example2