Horsea

A tiny module for running simple unit tests.

Installation

npm install --save horsea

Example

const test = require('horsea');

const square = num => num * num;

test.block('When using the "square" function', () => {
  test.assert(square(4) === 16, 'The return value should be the square of the input value');
});

test.end();

$ node square.test.js 

When using the "square" function:

    PASS The return value should be the square of the input value

1 tests passed
0 tests failed

Usage

You always need to use require('horsea') in test files.
You can run the tests by usual node means (require('test-file.js') or node test-file.js).

Methods

block

Defines a new block of test assertions. The provided message is used as a block header.
This is mainly used as a way to neatly format output.

Arguments

{String} message - The block header to display. {Function} func - A function containing test assertions to run.

assert

If expression is truthy, the word "PASS" is printed, else the word "FAIL" is printed. The message provided is then displayed immediately afterwards.

Arguments

{Mixed} expression - An expression to evaluate for "truthiness".
{String} message - A message to display.

end

Signals the end of the test and prints the total number of failing and passed tests. Takes no arguments.