Example of Creating Dynamic Tests/Suites in TestBox BDD Syntax

TestBoxBDDDynamicSuitesExample.cfc

component
	extends="testbox.system.BaseSpec"
	hint="This is an example of a TestBox BDD test bundle containing dynamically-defined suites."
{
	
	/*
	* Need to do config for *dynamic* test suites here, in the pseudo-
	*  constructor, versus in beforeAll(). See explanation here:
	*  https://goo.gl/gosdBK
	*/
	doDynamicSuiteConfig();
	
	/*
	* @hint This function is arbitrarily named, but it sets up a var needed by the dynamic tests example
	*/
	function doDynamicSuiteConfig(){
		variables.dynamicSuiteConfig = ["foo","bar","baz"];
	}
	
	function run( testResults, testBox ){

		/*
		* @hint Dynamic Test Suite Example
		*/
		// loop over test metadata
		for ( var thing in dynamicSuiteConfig ) {
			describe("Dynamic Suite #thing#", function(){
				// notice how data is passed into the it() closure:
				//  * data={keyA=valueA, keyB=ValueB}
				//  * function( data )
				it( title=thing & "test", data={thing=thing}, body=function( data ) {
					var thing = data.thing;
					expect(thing).toBe(thing);
				});
			});
		}
	
	}

}