antr

Asynchronous Node Test Runner

Why?

We had the need for a runner which runs tests asynchronously.

Install

npm install antr

Usage

Just require the module and you're away!

var Antr = require('antr');

var run = new Antr({
	dirname: __dirname,
	filter: /test([^\/w]+?)\.js$/
});

You can pass a callback in as the second parameter if you like, which will callback with err, stats. If you don't give antr a callback it will quit the process for you.

var Antr = require('antr');

var run = new Antr({
	dirname: __dirname,
	filter: /test([^\/w]+?)\.js$/
}, function(err, stats){
	console.log('Tests failed: ', stats.failed);
});

Stats contains

• passed
• failed
• total
• failRate - percentage of failed tests
• failedTests - array of file paths
• passedTests - array of file paths
• timeTaken - format hh:mm:ss

Options

Required

• filter Regex to filter files to run

Optional

• dirname Directory to find files in - defaults to . This can be an array of directories
• listFiles Print out the array of files which will be run - defaults to false
• timeout A timeout, in seconds, for each test - defaults to 30
• batchSize Maximum amount of concurrent tests to run - defaults to 8
• progressBar Option to display a progress bar - defaults to true
• succinct Option to limit the amount of output on stdout/stderr - defaults to false
• sort Sort function (to behave like a [].sort compareFunction), in case you need to customise the order in which the discovered tests are run.

npm Maintainers

• Joe Warren
• Jack Cannon