Module Lifecycle Object

// lifecycle object passed in to Test.module()...
Test.module(modulePath[, lifecycle]);

Test.module("Tests/Test.js/Signals", {
	setup: function(state) {
		// make all tests in the module require the
		// previous test to have passed
		REQUIRE("^");
	}
});
 
Test("will fail", Test.ANY( ), function() {
	ABORT( ); // fail here
});
 
// the setup() function will fail the requirement
// and prevent this test from even running
Test("will fail", Test.ANY( ), function() {
	ok( true, "Will this fail?" );
});

// teardown function called immediately after each unit
// test in the module, including Test.APPEND( ) mode
Test.module("Tests/Test.js/Signals", {
	teardown: function(state) {
		// add a comment based on test state
		switch (state) {
			case Test.TEST_RUNNING: {
				comment( "This could take a while" );
				break;
			}
			case Test.TEST_SUCCESS: {
				comment( "AWSOME WIN!" );
				break;
			}
			case Test.TEST_FAILED: {
				comment( "EPIC FAIL!" );
				break;
			}
			// Note: Test.UNIT_TIMEOUT will never
			// reach teardown as test will have
			// resolved to Test.UNIT_SUCCESS or
			// Test.UNIT_FAILED by this point.
		}
	}
});
 
Test("will fail", Test.ANY( ), function() {
	ABORT( ); // fail here
});
// will have "EPIC FAIL!" comment added to it's results
 
Test("will timeout", Test.ASYNCH( 10 ), function() {
	// will pass after 
});
// Gets "This could take a while" comment added first,
// then after timeout an "AWESOME WIN!" comment

Test.module("Tests/Test.js/Signals", {
	setup: function(state) {
		if (state === Test.UNIT_PENDING) {
			// stuff to do only at start of test session
		} else { // state === Test.UNIT_RUNNING or Test.UNIT_TIMEOUT
			// stuff to if appending / timeout
		}
	}
	teardown: function(state) {
		if (state === Test.UNIT_SUCCESS || state === Test.UNIT_FAILED) {
			// stuff to do only at end of test session
		} else { // state === Test.UNIT_RUNNING
			// stuff to do if still running (waiting for appends / timeout)
		}
	}
});