说说NG里的单元测试
转自:http://www.ngnice.com/posts/dc4b032b537ae0
当ng项目越来越大的时候,单元测试就要提上日程了,有的时候团队是以测试先行,有的是先实现功能,后面再测试功能模块,这个各有利弊,今天主要说说利用karma和jasmine来进行ng模块的单元测试.
什么是Karma
karma是一个单元测试的运行控制框架,提供以不同环境来运行单元测试,比如chrome,firfox,phantomjs等,测试框架支持jasmine,mocha,qunit,是一个以nodejs为环境的npm模块.
安装测试相关的npm模块，一般的运行karma的话只需要下面两个npm命令，第二个是一个测试框架，karma默认的。
- npm install -g karma
- npm install -g karma-jasmine
安装karma的时候也会自动的安装一些常用的模块
然后一个典型的运行框架通常都需要一个配置文件,在karma里可以是一个karma.conf.js,里面的代码是一个nodejs风格的,一个普通的例子如下
// Karma configuration // Generated on Wed Apr 08 2015 09:26:37 GMT+0800 (中国标准时间) /*global module:true*/ (function () { 'use strict'; module.exports = function (config) { config.set({ basePath: '', frameworks: ['jasmine'], files: [ "lib/angular.js", "lib/*.js", "js/*.js", "test/*.js" ], exclude: [ "lib/angular-scenario.js" ], urlRoot: "/base", preprocessors: {}, reporters: ['progress'], port: 9876, colors: true, logLevel: config.LOG_INFO, autoWatch: true, browsers: ['Chrome'], singleRun: false }); }; }());
karma就讲到这里,想了解更多关于它的信息可以,点击这里
什么是jasmine
jasmine是一个行为驱动开发的测试框架,不依赖任何js框架以及dom,是一个非常干净以及友好API的测试库.
下面简单的以一个例子来说明它的用法
定义一个测试文件命令为test.js
(function () { "use strict"; describe("A suite of basic functions", function () { it("contains spec with an expectation", function () { expect(true).toBe(true); }); var a; it("and so is a spec", function () { a = true; expect(a).toBe(true); }); }); }());
上面的例子来自于官网,这里只说下几个重要的API,更多的用法请,点击这里
-
首先任何一个测试用例以
describe函数来定义,它有两参数,第一个用来描述测试大体的中心内容,第二个参数是一个函数,里面写一些真实的测试代码 -
it是用来定义单个具体测试任务,也有两个参数,第一个用来描述测试内容,第二个参数是一个函数,里面存放一些测试方法 -
expect主要用来计算一个变量或者一个表达式的值,然后用来跟期望的值比较或者做一些其它的事件 -
beforeEach与afterEach主要是用来在执行测试任务之前和之后做一些事情,上面的例子就是在执行之前改变变量的值,然后在执行完成之后重置变量的值
最后要说的是,describe函数里的作用域跟普通JS一样都是可以在里面的子函数里访问的
想要运行上面的测试例子可以通过karar来运行,命令例子如下
karma start karma.conf.js
下面我们重点的说说ng里的控制器,指令,服务模块的单元测试.
NG的单元测试
因为ng本身框架的原因,模块都是通过di来加载以及实例化的,所以为了方便配合jasmine来编写测试脚本,所以官方提供了angular-mock.js的一个测试工具类来提供模块定义,加载,注入等.
下面说说ng-mock里的一些常用方法
- angular.mock.module 此方法同样在window命名空间下,非常方便调用
module是用来配置inject方法注入的模块信息,参数可以是字符串,函数,对象,可以像下面这样使用
beforeEach(module('myApp.filters'));
beforeEach(module(function($provide) {
$provide.value('version', 'TEST_VER');
}));
它一般用在beforeEach方法里,因为这个可以确保在执行测试任务的时候,inject方法可以获取到模块配置
- angular.mock.inject 此方法同样在window命名空间下,非常方便调用
inject是用来注入上面配置好的ng模块,方面在it的测试函数里调用,常见的调用例子如下
describe("ng-mock test", function () {
//提前加载模块
beforeEach(module('test'));
//测试value,function中的参数是自动注入
it('should provide a version', inject(function (author, version) {
expect(version).toEqual('1.0.0');
expect(author).toEqual('wwy');
}));
//用$provide修改value值
it('should override a version and test the new version is injected', function () {
module(function ($provide) {
$provide.value('version', 'overridden');
});
inject(function (version) {
expect(version).toEqual('overridden');
});
});
});
上面是官方提供的一些inject例子,代码很好看懂,其实inject里面就是利用angular.inject方法创建的一个内置的依赖注入实例,然后里面的模块注入跟普通ng模块里的依赖处理是一样的
简单的介绍完ng-mock之后,下面我们分别以控制器,指令,过滤器来编写一个简单的单元测试。
定义一个简单的控制器
var myApp = angular.module('myApp',[]);
myApp.controller('MyController', function($scope) {
$scope.spices = [{"name":"pasilla", "spiciness":"mild"},
{"name":"jalapeno", "spiciness":"hot hot hot!"},
{"name":"habanero", "spiciness":"LAVA HOT!!"}];
$scope.spice = "hello feenan!";
});
然后我们编写一个测试脚本
describe('myController function', function () {
describe('myController', function () {
var $scope;
beforeEach(module('myApp'));
beforeEach(inject(function ($rootScope, $controller) {
$scope = $rootScope.$new();
$controller('MyController', {
$scope: $scope
});
}));
it('should create "spices" model with 3 spices', function () {
expect($scope.spices.length).toBe(3);
});
it('should set the default value of spice', function () {
expect($scope.spice).toBe('hello feenan!');
});
});
});
上面利用了$rootScope来创建子作用域,然后把这个参数传进控制器的构建方法$controller里去,最终会执行上面的控制器里的方法,然后我们检查子作用域里的数组数量以及字符串变量是否跟期望的值相等.
想要了解更多关于ng里的控制器的信息,可以点击这里
定义一个简单的指令
var app = angular.module('myApp', []); app.directive('aGreatEye', function () { return { restrict: 'E', replace: true, template: '<h1>lidless, wreathed in flame, {{1 + 1}} times</h1>' }; });
然后我们编写一个简单的测试脚本
describe('Unit testing great quotes', function () {
var $compile;
var $rootScope;
// Load the myApp module, which contains the directive
beforeEach(module('myApp'));
// Store references to $rootScope and $compile
// so they are available to all tests in this describe block
beforeEach(inject(function (_$compile_, _$rootScope_) {
// The injector unwraps the underscores (_) from around the parameter names when matching
$compile = _$compile_;
$rootScope = _$rootScope_;
}));
it('Replaces the element with the appropriate content', function () {
// Compile a piece of HTML containing the directive
var element = $compile("<a-great-eye></a-great-eye>")($rootScope);
// fire all the watches, so the scope expression {{1 + 1}} will be evaluated
$rootScope.$digest();
// Check that the compiled element contains the templated content
expect(element.html()).toContain("lidless, wreathed in flame, 2 times");
});
});
上面的例子来自于官方提供的,最终上面的指令将会这用在html里使用
<a-great-eye></a-great-eye>
测试脚本里首先注入$compile与$rootScope两个服务,一个用来编译html,一个用来创建作用域用,注意这里的_,默认ng里注入的服务前后加上_时,最后会被ng处理掉的,这两个服务保存在内部的两个变量里,方便下面的测试用例能调用到
$compile方法传入原指令html,然后在返回的函数里传入$rootScope,这样就完成了作用域与视图的绑定,最后调用$rootScope.$digest来触发所有监听,保证视图里的模型内容得到更新
然后获取当前指令对应元素的html内容与期望值进行对比.
想要了解更多关于ng里的指令的信息,可以点击这里
定义一个简单的过滤器
var app = angular.module('myApp', []); app.filter('interpolate', ['version', function (version) { return function (text) { return String(text).replace(/\%VERSION\%/mg, version); }; }]);
然后编写一个简单的测试脚本
describe('filter', function () {
beforeEach(module('myApp'));
describe('interpolate', function () {
beforeEach(module(function ($provide) {
$provide.value('version', 'TEST_VER');
}));
it('should replace VERSION', inject(function (interpolateFilter) {
expect(interpolateFilter('before %VERSION% after')).toEqual('before TEST_VER after');
}));
});
});
上面的代码先配置过滤器模块,然后定义一个version值,因为interpolate依赖这个服务,最后用inject注入interpolate过滤器,注意这里的过滤器后面得加上Filter后缀,最后传入文本内容到过滤器函数里执行,与期望值进行对比.
总结
利用测试来开发NG有很多好处,可以保证模块的稳定性,还有一点就是能够深入的了解ng的内部运行机制,所以建议用ng开发的同学赶紧把测试补上吧!
浙公网安备 33010602011771号