Page Comparison

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

The scope of unit test functions is manipulated before a test runs, so you cannot reference variables defined in the function's scope chain (closures will not work either).

If you want to reference variables external to the functions, pass them in via the moduleData property in the lifecycle object.

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)
		}
	}
});