代码测试的必要性,对任何编程语言都毋需赘述,JavaScript和HTML自然不例外。本文描述如何对Ionic进行单元测试(Unit Tests)。
对于测试环境而言,目前框架很多,本文使用的是Karma,尤其是其本身就为Angular而生,故能够与Angular完美集成。
对于测试用例而言,框架也有很多,本文使用的是Jasmine。
本文工程基于ionic#1.2.4的tabs工程模板进行测试(angular#1.4.3),但是为了更加符合Angular 1编码规范,对工程的目录结构及代码的风格结构做了相应变化,大家可先熟悉源码后,再参照下文观看。
单元测试(Unit Tests)
单元测试,即Unit Tests,顾名思义,旨在测试代码中的某段独立功能。
安装测试环境
我们需要使用Karma、Jasmine以及angular-mocks:
$ npm install karma --save-dev $ npm install karma-jasmine --save-dev
注意:angular-mocks的版本必须与ionic使用的angular版本相同,否则可能会出现如下错误:
Failed to instantiate module ngMock... Unknown provider: $@H_403_25@$rAFProvider
本文使用的是ionic#1.2.4,其angular版本为1.4.3,故需安装angular-mocks#1.4.3
:
$ bower install angular-mocks#1.4.3 --save-dev
为了方便地在终端中使用karma进行测试,需要安装Karma CLI:
$ npm install -g karma-cli
注意:类Unix系统可能需要使用
suodo
:
$ sudo npm install -g karma-cli
最后,我们需要使用一种浏览器作为我们单元测试的载体,Karma支持大多数主流浏览器。这里我们使用最流行的PhantomJS:
$ npm install karma-phantomjs-launcher --save-dev
当然,可以使用别的浏览器,只需安装karma-*-launcher
即可,如:
$ npm install karma-chrome-launcher --save-dev $ npm install karma-firefox-launcher --save-dev ...
配置测试环境
进行编写测试用例之前,首先需要进行测试环境的配置:
$ karma init karma.conf.js
执行这条语句后,终端中会依次询问各项的配置信息,可以全部回车使用其默认值,待karma.conf.js
生成后,再进行手动修改:
打开karma.conf.js
,找到browsers
选项,将其值修改为PhantomJS
:
browsers: ['PhantomJS']
找到files
选项,根据自己的工程文件结构做出相应修改,如根据我的目录结构,其值应该类似于:
files: [
'www/lib/ionic/js/ionic.bundle.js','www/lib/angular-mocks/angular-mocks.js','www/js/*.js','www/views/**/*.js'
]
注意:要注意js的加载顺序,
ionic.bundle.js
集成了ionic和angular的相关文件,需要加载于普通工程js文件之前;同理,angular-mocks.js
是测试用例的先决条件,故需要加载于测试用例js文件之前。读者需要根据自身工程结构进行相应修改,如本文工程将单元测试用例js文件置于普通工程js文件一起,故使用www/views/**/*.js
即可代表他们。
编写测试用例
测试Controller
我们以Chats
页面的controller为例,编写测试用例,命名为tab-chats.controller.spec.js
:
(function () { 'use strict'; describe('ChatsCtrl',function () { var scopeMock,ChatsServiceMock,controller; beforeEach(module('starter')); beforeEach(inject(function ($rootScope,$controller,_ChatsService_) { scopeMock = $rootScope.$new(); ChatsServiceMock = _ChatsService_; controller = $controller('ChatsCtrl',{'$scope': scopeMock,'ChatsService': ChatsServiceMock}); })); it('should have scopeMock defined',function () { expect(scopeMock).toBeDefined(); }); it('should get an instance of ChatsService',function () { expect(ChatsServiceMock).toBeDefined(); }); it('should delete a person in chats',function () { var chat = { id: 0,name: 'Ben Sparrow',lastText: 'You on your way?',face: 'img/ben.png' }; scopeMock.remove(chat); expect(ChatsServiceMock.all().length).toBe(4); expect(scopeMock.chats.length).toBe(4); }); }); })();
说明:
1.首先使用
module
方法(angular-mocks.js提供)加载工程module,而且将其置于beforeEach
方法(jasmine提供)中,能够保证其能够在测试用例执行之前被首先执行。
2.然后我们使用inject
方法插入了一些必要模块: $rootScope用来实例化scope对象; $controller用来实例化controller。
3.$controller
方法接收两个参数,第一个参数为要实例化的controller的名称,第二个参数为此controller的依赖列表。
4.测试用例也是编程,若对其语法不了解,首先需要熟悉Jasmine。
执行测试:
$ karma start karma.conf.js
describe
方法使得我们可以组合多个测试,it
方法定义了实际的测试用例,注意他们的第一个参数都是说明性文字,即自述性,这样就为测试的调试提供了极大的便利,expect
方法处于it
方法之间,用于测试各功能点是否按照我们的预期那样执行。每个it
方法中可使用任意多个expect
方法,不过要酌情处理,否则不易于排错。
测试Service
我们以Chats
页面的service为例,编写测试用例,命名为tab-chats.service.spec.js
:
(function () { 'use strict'; describe('ChatsService',function () { var ChatsService; beforeEach(module('starter')); beforeEach(inject(function (_ChatsService_) { ChatsService = _ChatsService_; })); it('can get an instance of ChatsService',function () { expect(ChatsService).toBeDefined(); }); it('should has 5 chats',function () { expect(ChatsService.all().length).toBe(5); }); it('should has Max as friend with id 1',function () { var friend = { id: 1,name: 'Max Lynx',lastText: 'Hey,it\'s me',face: 'img/max.png' }; expect(ChatsService.get(1)).toEqual(friend); }); }); })();
执行测试:
$ karma start karma.conf.js
源码可在Github上找到。
参考文档:
ionic工程组织文件
Angular Unit Tests
unit-testing-ionic-app
write-automated-unit-tests