WebHammer

-c CONFIG, --config CONFIG
                        Config file path for luantai.
-f FILE, --file FILE  The javascript file which you want to test. Multi 
                      file splited by ','.
-p PLUGINS, --plugins PLUGINS
                      Luantai plugin. Multi file splited by ','.
-e ENV, --env ENV     Enviroment prepare file. Multi file splited by ','.
-r RULE, --rule RULE  Rule for filter test files. Only RegExp accepted!

执行解析

• 栾台分为两个进程, 一个stage进程, 一个phantom进程.

• stage进程处理参数信息以及加载和运行插件, phantom进程执行所有的前端单元测试逻辑.

• phantom 进程在初始化完毕之后会打开一个空白的tab页面, 提供单元测试的环境.

• 所有在phantom中执行的文件通过scriptloade机制加载进入phantom, 具体在插件部分有解释.

• phantom执行结束后, 将所有测试信息返回stage进程, stage进程处理后输出给用户.

config 配置文件

config是一个json文件, 配置单元测试信息. 假如同时使用-c参数和其他参数(例如:-f), 以-c参数指定的配置文件为准, 其他参数会被忽略.

{	
	// file, 一个数组, 里面可以是单个文件, 也可以是一个文件夹
	"file" : [
		// 一个单一的测试文件
		'/home/admin/test-project/test/test-luantai.js',
		// 一个测试文件夹, 会对里面所有的文件跑mocha, 可以配合"rule"参数使用。
		'/home/admin/test-project/test2',
	],
	// rule, 一个字符串, 用于过滤"file"中的文件, 只有符合正则的文件, 才会被mocha运行.
	// 目前仅接受正则.
	"rule" : "test.*",
	// 目前插件执行顺序已经加载顺序都和数组的顺序相同, 具体插件的使用请参考下面插件的详细信息.
	"plugins" : [
		{
			// 这个json的key, 是插件的名字, 目前插件可以在三个位置：
			// 1. 栾台内置插件, 直接使用名字即可.
			// 2. node_modules 里面的插件, 也可以直接使用名字.
			// 3. 用户自定义插件, 需要填写插件的绝对路径, e.g: {
			//       "/home/admin/test/test-plugin.coffee" : {}
			//    }
			"cube" : {
				// 资源文件目录, 默认程序执行路径下的"./res"文件夹. 可以是绝对路径, 也可以是
				// 相对路径, 相对于当前程序执行路径.
				"resDir"  : "./res",
				// 资源文件目录, 默认程序执行路径下的"./tests"文件夹. 可以是绝对路径, 也可以是
				// 相对路径, 相对于当前程序执行路径.
				"testDir" : "./test"
				// cube 的urlbase参数, 默认: "/"
				"urlBase" : "/"
			}
		}
		{
			"istanbul" : {}
		}
	],
	// 环境准备文件, 假如测试需要很多类库, 例如: jquery, ext等, 可以在这里加载进去, 在
	// 开始跑具体的单元测试之前, 这些文件都会保证加载完毕.
	// 执行逻辑和"file"参数一样, 可以是单个文件, 也可以是一个文件夹, 但是不受"rule"参数作用.
	"env" : [
		
	]
}

命令行参数解析

• -f 同"file"参数, 多个文件之间用,分隔, 可以是单个文件, 也可以是文件夹

• -p 同"plugins"参数, 多个插件之间用,分隔, 但是无法设定具体的参数. e.g: -p cube,istanbul

• -r 同"rule"参数, 只能用正则. e.g: -r 'test.*'

• -e 同"env"参数, 逻辑和-f参数相同, 不受-r参数影响.

luantai 插件机制

栾台本身作为一个提供跑单元测试的容器, 其功能仅仅只是把单元测试跑完, 并给出结果, 所以, 其他的一些功能都通过插件实现, 例如覆盖率。 栾台提供了丰富的接口供插件使用, 具体使用方法如下:

这是一个具体的插件文件:

class TestPlugin
	
	// options 参数的值是在config文件中设置的, 例如config文件如下：
   // {
   //   plugins : [
   //       {
   //           cube : {
   //               test : 'abcd'
   //           }
   //       }
   //   ]
   // }
   // 那么, 这里options的值就是 
   // {
   //   test : 'abcd'
   // }}
   // done参数, contructor 函数可以是一个异步的方法.
	constructor : ( options, done ) ->
	
	// 当luantai server在挂载中间件之前时会执行的方法.
	// app参数是一个connect实例, 你可以挂载自己的中间件执行逻辑.
	// done 可以是一个异步方法.
	beforeMountMiddleware : ( app, done ) ->

	// 当luantai server在将所有的中间件挂载结束之后会执行的方法.
	// app参数是一个connect实例, 你可以挂载自己的中间件执行逻辑.
	// done 可以是一个异步方法.	
	afterMountMiddleware : ( app, done ) ->
	
	// 所有在phantom中执行的测试都通过scriptloader机制加载进入phantom.
	// 具体参见后面的详细解释
	scriptLoader : ( done ) ->
		done null, ( file, done ) ->
		    done null, """
		    Cube.init( {
		        base : \"#{urlBase}\",
		        enableCss : true
		      } );
		      Cube.use( \"/__test__#{file}\", function() {
		        window.callPhantom( 'luantai.scriptload.done' );
		      } );
		    """
	
	// 插件将自己所需要的前端JS文件注入到phantom中去.
	injectJs : ( done ) ->
		done null, [
		    '/home/admin/test/test.js',
		    '/home/admin/test/test2.js',
		]
	
	// feedback反馈机制, 将phantom进程具体window对象下面的某一个属性返回.
	feedback : ( done ) ->
		done null, [ 'test1', test2 ]

// 暴露一个类
module.exports = TestPlugin

scriptloader

scriptloader可以让插件选择自己应该以何种方式加载进入phantom, 默认情况下, luantai会将测试文件, 也就是"file"参数中指定的文件读入内存, 然后发送给phantom进程, 通过new Function的方式将代码文本进行执行。

fs.readFile file, ( err, data ) ->
	unless err
	  data = """
	  #{data}
	  ;window.callPhantom( 'luantai.scriptload.done' );
	  """
	  done null, data

这是默认的script loader, 通过读文件的方式, 将测试文件读入内存, 然后执行完成后, 需要调用 window.callPhantom( 'luantai.scriptload.done' );方法，表明文件已经加载完毕, 可以开始加载下一个文件啦.