Mastering Node.js Unit Testing: TDD vs BDD, Mocha, and Assertion Libraries

Story: Xiao Ming, a front‑end engineer, started a Node.js project with Koa and faced deployment, regression, and refactoring concerns.

He was advised to adopt unit testing. He learned about two test styles—TDD and BDD—and compared their syntax.

// TDD example
suite('Array', function () {
  setup(function () {});
  test('equal -1 when index > array length', function () {
    assert.equal(-1, [1,2,3].indexOf(4));
  });
});

// BDD example
describe('Array', function () {
  before(function () {});
  it('should return -1 when no such index', function () {
    [1,2,3].indexOf(4).should.equal(-1);
  });
});

He preferred BDD because its syntax reads more like natural language.

Test Frameworks

In the Node.js ecosystem, Mocha is the most popular framework. Its features include TDD/BDD syntax, async testing, and hooks.

Example with Mocha and before/after hooks:

var User = require('./models/user');

describe('models/user', function () {

  before(function (done) {
    User.new({name: 'Xiao Ming'}, done);
  });

  after(function (done) {
    User.delete({name: 'Xiao Ming'}, done);
  });

  it('should return an Object when find by name="Xiao Ming"', function (done) {
    User.find({name: 'Xiao Ming'}, function (err, user) {
      if (err) return done(err);
      user.should.be.an.Object();
      user.name.should.equal('Xiao Ming');
      done();
    });
  });
});

Mocha does not ship with an assertion library, so various libraries can be used. Xiao Ming compared several options and chose should.js for its readable, English‑like API.

Assertion Libraries Comparison

He listed four common libraries: Node.js core assert (no external dependency, weak syntax), should.js (very semantic, poor docs), expect.js (middle‑ground), and chai (comprehensive API).

Sample syntax:

// assert
assert.equal(value, 1);

// should
value.should.equal(1);
value.should.be.a.Number();

// expect
expect(1).to.equal(1);
expect(value).to.be.a('number');

Coverage

To measure how much code is exercised, Xiao Ming uses istanbul, which reports statement, branch, function, and line coverage. Example report screenshot:

Conclusion

After learning the concepts of test types, frameworks, assertion libraries, and coverage, Xiao Ming gained a solid foundation for unit testing in Node.js and plans to share more advanced scenarios later.