test-director

An ultra lightweight unit test director for Node.js.

Works well with any assertion library that throws errors, such as the Node.js assert API and snapshot-assertion.

Setup

To install from npm run:

npm install test-director --save-dev

Support

• Node.js 10 - 12 || >= 13.7

API

Table of contents

• class TestDirector
  • TestDirector instance method add
  • TestDirector instance method run
  • TestDirector instance property tests

class TestDirector

An ultra lightweight unit test director for Node.js.

Examples

Import and construct a new test director.

const { TestDirector } = require('test-director');
 
const tests = new TestDirector();

TestDirector instance method add

Adds a test.

Examples

A sync test.

const { equal } = require('assert');
const { TestDirector } = require('test-director');
 
const tests = new TestDirector();
 
tests.add('JavaScript addition.', () => {
  equal(1 + 1, 2);
});
 
tests.run();

An async test.

const { ok } = require('assert');
const fetch = require('node-fetch');
const { TestDirector } = require('test-director');
 
const tests = new TestDirector();
 
tests.add('GitHub is up.', async () => {
  const { ok } = await fetch('https://github.com');
  ok(ok);
});
 
tests.run();

TestDirector instance method run

Runs the tests one after another, in the order they were added.

Returns: Promise<void> — Resolves once tests have run.

Examples

Run nested tests.

const { TestDirector } = require('test-director');
 
const tests = new TestDirector();
 
tests.add('Test A.', async () => {
  const tests = new TestDirector();
 
  tests.add('Test B.', () => {
    // …
  });
 
  tests.add('Test C.', () => {
    // …
  });
 
  await tests.run(true);
});
 
tests.add('Test D.', () => {
  // …
});
 
tests.run();

TestDirector instance property tests

A map of test functions that have been added, keyed by their test names.

Type: Map<string, Function>