README.md

Continuable Mocha

A small library that allows one Mocha test to 'continue from' another.

​_continues-from_​ may be considered an anti-pattern by some, since you can use beforeEach within nested define blocks to get your tests into the correct state, but we find it useful when porting pre-BDD tests.

Usage

Require the continuable-mocha library and call 'install', this will install the necessary global functions.

var continuableMocha require('continuable-mocha');
// or
import continuableMocha from 'continuable-mocha';

continuableMocha.install();

To continue from a test call continueFrom providing either the name of the test in the same suite or the full suite and test name separated by :: characters.

var continuableMocha = require('continuable-mocha');
continuableMocha.install();

describe('my suite', function() {

	it('a test', function() {
		// a test
	});

	it('ignored test', function() {
		// a test
	});

	it('continue from another', function() {
		continueFrom('a test');
	});

	it('continue from ignored test', function() {
		continueFrom('ignored test');
	});

	it('continue from a nested suite test', function() {
		continueFrom('nested suite::nested suite test');
	});

	it('continue from a doubly nested suite test', function() {
		continueFrom('nested suite::doubly nested suite::nested suite test');
	});

	describe('nested suite', function() {

		it('nested suite test', function() {
			// a test
		});

		describe('doubly nested suite', function() {

			it('nested suite test', function() {
				// a test
			});

		});

	});

});

Development

• the source code is in src
• tests are in test. Run default tests command via npm test. npm run test:node:debug or npm run test:browser:debug can be used to start a persistent test process which watches the director.