nodeJS grunt karma+jasmine+require 快速构建前台自动化测试环境搭建
前台自动化测试环境搭建前言
在Java领域，Apache, Spring, JBoss 三大社区的开源库，包罗万象，但每个库都在其领域中都鹤立鸡群。而Nodejs中各种各样的开源库，却让人眼花缭乱，不知从何下手。
Nodejs领域: Jasmine做单元测试，Karma自动化完成单元测试，Grunt启动Karma统一项目管理，Yeoman最后封装成一个项目原型模板，npm做nodejs的包依赖管理，bower做javascript的包依赖管理。
Java领域：JUnit做单元测试, Maven自动化单元测试，统一项目管理，构建项目原型模板，包依赖管理。
Nodejs让组合变得更丰富，却又在加重我们的学习门槛。我还说不清楚，也看不透！
上面写的有点远了，回到文章的主题，Jasmine+Karma自动化单元测试。
1．Karma简介
Karma是Testacular的新名字，在2012年google开源了Testacular，2013年Testacular改名为Karma。Karma是一个让人感到非常神秘的名字，表示佛教中的缘分，因果报应，比Cassandra这种名字更让人猜不透！
Karma是一个基于Node.js的JavaScript测试执行过程管理工具（Test Runner）。该工具可用于测试所有主流Web浏览器，也可集成到CI（Continuous integration）工具，也可和其他代码编辑器一起使用。这个测试工具的一个强大特性就是，它可以监控(Watch)文件的变化，然后自行执行，通过console.log显示测试结果。
Jasmine是单元测试框架，本单将介绍用Karma让Jasmine测试自动化完成。
istanbul是一个单元测试代码覆盖率检查工具，可以很直观地告诉我们，单元测试对代码的控制程度。
2．Jasmine简介
Jasmine是一个用来编写Javascript测试的框架，它不依赖于任何其它的javascript框架，也不需要DOM。它有拥有灵巧而明确的语法可以让你轻松的编写测试代码。
jasmine的结构很简单：
describe("A suite", function() {
var foo;
beforeEach(function() {
foo = 0;
foo += 1;
});
afterEach(function() {
foo = 0;
});
it("contains spec with an expectation", function() {
expect(true).toBe(true);
});
});
每个测试都在一个测试集中运行，Suite就是一个测试集，用describe函数封装。 Spec表示每个测试用例，用it函数封装。通过expect函数，作为程序断言来判断相等关系。setup过程用beforeEach函数封装，tearDown过程用afterEach封装。
3.Karma的安装
3.1:系统环境:
win7 64bit, node v0.10.32, npm 1.4.28
3.2:开始安装karma
E:\workspace npm install -g karma
注：-g代表全局安装
3.4:测试是否安装成功
E:\workspace karma start
打开浏览器访问http:\\localhost:9876出现下面界面表示OK
4karma+jasmine+requirejs
4.1:初始化karma配置文件karma.conf.js
~ D:\workspace\javascript\karma>karma init
Which testing framework do you want to use ?
Press tab to list possible options. Enter to move to the next question.
> jasmine
注：测试框架选择
Do you want to use Require.js ?
This will add Require.js plugin.
Press tab to list possible options. Enter to move to the next question.
> yes
注：需不需要引入requirejs
引入requirejs的原因：加载相互依赖的js文件
Do you want to capture a browser automatically ?
Press tab to list possible options. Enter empty string to move to the next question.
> Chrome
>
注：选择打开的浏览器
What is the location of your source and test files ?
You can use glob patterns, eg. "js/*.js" or "test/**/*Spec.js".
Enter empty string to move to the next question.
>
注：karma启动时加载的目标文件和测试文件
Should any of the files included by the previous patterns be excluded ?
You can use glob patterns, eg. "**/*.swp".
Enter empty string to move to the next question.
>
注：加载的目标文件不需要测试的文件
Do you want Karma to watch all the files and run the tests on change ?
Press tab to list possible options.
> yes
注：karma要不要动态监听目标文件和测试用例变化
Config file generated at "D:\workspace\javascript\karma\karma.conf.js".
这个指令跑完后你就会发现目录底下多了个配置文件karma.conf.js，test-main.js
karma.conf.js：karma配置文件
test-main.js: requireJS配置文件
4.2.Karma第一次启动时的问题
1，chrome的plugins
~ E:\workspace npm install karma-chrome-launcher--save-dev
2，环境变量CHROM­_BIN的问题
~ D:\workspace\javascript\karma>karma start
INFO : Karma v0.10.2 server started at http://localhost:9876/
INFO : Starting browser Chrome
ERROR : Cannot start Chrome
Can not find the binary C:\Users\Administrator\AppData\Local\Google\Chrome\Application\chrome.exe
Please set env variable CHROME_BIN
设置chrom的CHROM­_BIN
~ E:\workspace Set CHROM­_BIN= “C:/Program Files (x86)/Chrome/chrome.exe”
4.3.安装集成包karma-jasmine
~ E:\workspace npm install karma-jasmine
4.4. Requirejs简介
RequireJS是一个Javascript 文件和模块框架，可以从 http://requirejs.org/下载，如果你使用Visual Studio也可以通过Nuget获取。它支持浏览器和像node.js之类的服务器环境。使用RequireJS,你可以顺序读取仅需要相关依赖模块。
RequireJS所做的是，在你使用script标签加载你所定义的依赖时，将这些依赖通过head.appendChild()函数来加载他们。当依 赖加载以后，RequireJS计算出模块定义的顺序，并按正确的顺序进行调用。这意味着你需要做的仅仅是使用一个“根”来读取你需要的所有功能，然后剩下的事情只需要交给RequireJS就行了。为了正确的使用这些功能，你定义的所有模块都需要使用RequireJS的API，否者它不会像期望的那样 工作。
4.5.安装集成包 requires
通过nodejs安装RequireJS
~ E:\workspace npm install requires –save-dev
~ E:\workspace npm install karma-requires –save-dev
注：-save-dev : 可以直接 安装的包自动添加到grunt包管理配置文件中
4.6. RequireJS配置
在一般的web项目中 require都是通过<sricpt>标签静态加载到项目中去的
例如：< sricpt data-main=”main.js” src=”require.js”></ sricpt >
注：RequireJS是怎么开始工作：当RequireJS被加载的时候，它会使用 data-main属性去搜寻一个脚本文件（它应该是与使用src加载RequireJS是相同的脚本）。data-main需要给所有的脚本文件设置一 个根路径。根据这个根路径，RequireJS将会去加载所有相关的模块。
Data-main:指向的requirejs的配置文件
配置test-main.js
// This file is test/spec/main.js
var allTestFiles = [];
var TEST_REGEXP = /(spec|test)\.js$/i;
var pathToModule = function(path) {
return path.replace(/^\/base\//, '').replace(/\.js$/, '');
};
Object.keys(window.__karma__.files).forEach(function(file) {
if (TEST_REGEXP.test(file)) {
// Normalize paths to RequireJS module names.
allTestFiles.push(pathToModule(file));
}
});
require.config({
// Karma serves files under /base, which is the basePath from your config file
baseUrl: 'base/src/js',
paths: {
'mootools' : ' lib/mootools',
'jquery' : 'lib/jquery-1.10.2',
'jquery-ui' : 'ib/jquery-1.10.2/jquery-ui'
},
shim: {
'jquery-ui': {
deps: ['jquery']
}
},
// dynamically load all test files
deps: allTestFiles,
// we have to kickoff jasmine, as it is asynchronous
callback: window.__karma__.start
});
再通过 karma 配置文件将其引入
files: [
{pattern: 'src/js/lib/*.js', included: false},
{pattern: 'src/js/apps/*.js', included: false},
{pattern: 'test/*-spec.js', included: false},
'test/*-spec.js',
‘test-main.js',
'src/*.js'
],
5.自动单元测试
5.1:三步准备工作：
创建源文件
源文件：用于实现某种业务逻辑的文件，就是我们平时写的js脚本
假如我们的源文件原来有个需求有一个需求：要实现单词倒写的功能，如：”ABCD” ==> “DCBA”
Src/test.js
function reverse(name){
return name.split("").reverse().join("");
}
创建测试文件
测试文件：符合jasmineAPI的测试js脚本
Test/spec/module1/test-spec.js
describe("A suite of basic functions", function() {
it("reverse word",function(){
expect("DCBA").toEqual(reverse("ABCD"));
});
});
修改karma .conf.js
前期 自动生成的配置文件比较凌乱，而且有好多地方配置不到位，这个时候大家可以地下的代码 替换其内容
module.exports = function(config) {
config.set({
// base path, that will be used to resolve files and exclude
basePath: '',
// frameworks to use
frameworks: ['jasmine', 'requirejs'],
// list of files / patterns to load in the browser
files: [
{pattern: 'src/js/apps/inspect/*.js', included: false},
{pattern: 'src/js/modules/*.js', included: false},
{pattern: 'src/js/lib/*.js', included: false},
{pattern: 'src/js/apps/settings/*.js', included: false},
{pattern: 'test/spec/**/*-spec.js', included: false},
'test-main.js'
],
preprocessors: {
'src/js/apps/inspect/*.js': ['coverage']
},
// list of files to exclude
exclude: [],
// test results reporter to use
// possible values: 'dots', 'progress', 'junit', 'growl', 'coverage'
reporters: ['progress', 'coverage'],
coverageReporter: {
type: 'html',
dir: 'coverage/'
},
// web server port
port: 9876,
// enable / disable colors in the output (reporters and logs)
colors: true,
// level of logging
// possible values: config.LOG_DISABLE || config.LOG_ERROR || config.LOG_WARN || config.LOG_INFO || config.LOG_DEBUG
logLevel: config.LOG_INFO,
// enable / disable watching file and executing tests whenever any file changes
autoWatch: true,
// Start these browsers, currently available:
// - Chrome
// - ChromeCanary
// - Firefox
// - Opera (has to be installed with `npm install karma-opera-launcher`)
// - Safari (only Mac; has to be installed with `npm install karma-safari-launcher`)
// - PhantomJS
// - IE (only Windows; has to be installed with `npm install karma-ie-launcher`)
browsers: ['Chrome'],
// If browser does not capture in given timeout , kill it
captureTimeout: 60000,
// Continuous Integration mode
// if true, it capture browsers, run tests and exit
singleRun: false
});
};
5.2.测试requireJS
1.将前面的test.js剪切至src/js/apps/inspect/
2.修改karma配置文件引入路径
3. 运行karma start会出现下面的结果
6.Karma统计UT覆盖率输出报告
~ E:\workspacenpm install karma-coverage
注：打完指令如果细心观察你就会发现karma的配置文件中多了蓝色部分代码，是对UT覆盖率输出的配置。
module.exports = function(config) {
config.set({
// base path, that will be used to resolve files and exclude
basePath: '',
// frameworks to use
frameworks: ['jasmine', 'requirejs'],
// list of files / patterns to load in the browser
files: [
{pattern: 'src/js/apps/inspect/*.js', included: false},
{pattern: 'src/js/modules/*.js', included: false},
{pattern: 'src/js/lib/*.js', included: false},
{pattern: 'src/js/apps/settings/*.js', included: false},
{pattern: 'test/spec/**/*-spec.js', included: false},
'test-main.js'
],
preprocessors: {
'src/js/apps/inspect/*.js': ['coverage']
},
// list of files to exclude
exclude: [],
// test results reporter to use
// possible values: 'dots', 'progress', 'junit', 'growl', 'coverage'
reporters: ['progress', 'coverage'],
coverageReporter: {
type: 'html',
dir: 'coverage/'
},
// web server port
port: 9876,
// enable / disable colors in the output (reporters and logs)
colors: true,
// level of logging
// possible values: config.LOG_DISABLE || config.LOG_ERROR || config.LOG_WARN || config.LOG_INFO || config.LOG_DEBUG
logLevel: config.LOG_INFO,
// enable / disable watching file and executing tests whenever any file changes
autoWatch: true,
// Start these browsers, currently available:
// - Chrome
// - ChromeCanary
// - Firefox
// - Opera (has to be installed with `npm install karma-opera-launcher`)
// - Safari (only Mac; has to be installed with `npm install karma-safari-launcher`)
// - PhantomJS
// - IE (only Windows; has to be installed with `npm install karma-ie-launcher`)
browsers: ['Chrome'],
// If browser does not capture in given timeout , kill it
captureTimeout: 60000,
// Continuous Integration mode
// if true, it capture browsers, run tests and exit
singleRun: false
});
};启动karma start，在工程目录下面找到index.html文件，coverage/chrome/index.html
打开后，我们看到代码测试覆盖绿报告
点击文件路径进入文件夹点击文件可以此文件的UT覆盖率
有颜色的文件代表未覆盖到的文件(覆盖由好到坏显示显色绿，黄，红)
7 grunt 托管karma
7.1.Grunt 简介
Grunt是一个自动化的项目构建工具. 如果你需要重复的执行像压缩, 编译, 单元测试, 代码检查以及打包发布的任务. 那么你可以使用Grunt来处理这些任务, 你所需要做的只是配置好Grunt, 这样能很大程度的简化你的工作.
如果在团队中使用Grunt, 你只需要与其他人员约定好使用Grunt应该规避的问题, 就能够很方便的自动化的处理大部分的常见工作任务, 你所付出的努力几乎为0.
7.2.任务配置修改
Install grunt-karma
使用install grunt-karma –save-dev将 grunt-karma载入grunt包管理配置文件Gruntfile.js
Gruntfile.js中增加配置
注：任务配置
karma: {
unit: {
configFile: "karma.conf.js",
singleRun: true
}
},
注：载入模块文件
grunt.loadNpmTasks('grunt-karma');
注：定义具体的任务。第一个参数为任务名，第二个参数是一个数组，表示该任务需要依次使用的模块。default任务名表示，如果直接输入grunt命令，后面不跟任何参数，这时所调用的模块（该例为jshint，concat和uglify）
grunt.registerTask('unit', [‘jshint’, ‘concat’, ‘uglify’]);
grunt.registerTask('unit', ['karma']);
页:
[1]