ultimate-tests v0.0.7

UltimateTests

Provides flexible tests environment.

To use babel just create file .babelrc in project root and install needed dependencies.

Usage example:

File: test.js

const Tests = require( 'ultimate-tests' );

/* --------------------------------- Tests --------------------------------- */

new Tests({
	testsDir: './tests',    // default './'
    
    // default config for each testBlock
    // each testBlock can override this ( see below )
	defaultConfig: {
	    // defines which tests to run
	    testIndexes: {/* see below */},
        
		logs: {
		    // 0 - only system messages ( default )
            // 1 - system + info messages
            // 2 - all messages
            // 3 - print all hidden properties in objects
			level: 0,
			
			// advanced
			systemMessages: {/* see test-block.js  */}
		}
	},

	tests: {
		TestsBlock1: {
			file: 'tests-block-1',

			testIndexes: {
				only: [1,2,3],   // which tests will be executed by index
				except: []   // which tests will be omitted by index
			},
		},
	}
});

File: ./tests/tests-block-1.js

/**
 * Module must return function
 * @param (Function) assert( condition, errorMsg ) - is used to check test results
 * @param (Function) log( ...msg ) - is used to print some data
 * @param (Function) error( msg ) - is used to immediately throw error
 */
module.exports = ( assert, log, error ) => ({
    // Array of all tests ( required )
	tests: [{
		/* ------------ 1 ------------- */

		test( testIndex ) {
			// ... some test body ...
            // this.tests[ testIndex ]; // current test

			this.someHelper();
			
			log( 'a:', a );     // prints message if log.level >= 2
			log( 'b:', b );
			
			assert( a === b, 'something is wrong' );    // throws error if a !== b
			
			if ( a.x !== b.x ) error( 'this can not be' );  // throws error
			
			return Promise.resolve( testResult );  // if test might return Promise
		}
	}],

	someHelper() {},
});