JavaScript单元测试系列2：将Jasmine集成到JsTestDriver

2013-08-26

JavaScript单元测试系列二：将Jasmine集成到JsTestDriver?JavaScript单元测试系列二：将Jasmine集成到JsTest

JavaScript单元测试系列二：将Jasmine集成到JsTestDriver

大漠穷秋

接着上一篇。

什么是Jasmine

Jasmine（茉莉花）是一个用来对JavaScript进行单元测试的框架。

核心特点：

1、不依赖于其它任何框架；2、不需要DOM支持（也就是说可以脱离浏览器！）；3、行为驱动式语法，写起来非常简单；4、支持对异步调用的测试；5、可以在多种环境中运行（包括Ruby、NodeJS、Scala、Java、BPM、.net、Perl---我擦！真尼玛强大，具体参见下面的官方站点。）

官方站点： https://github.com/pivotal/jasmine/wiki

来自淘宝UED团队的研究文章：

http://www.36ria.com/4457

Quick Start

第一步：到这里https://github.com/pivotal/jasmine/downloads下载Jasmine standalone版；

JavaScript单元测试系列2：将Jasmine集成到JsTestDriver
?

第二步：在任意浏览器中打开SpecRunner.html，你将会看到以下内容；

JavaScript单元测试系列2：将Jasmine集成到JsTestDriver
?

好了，这就是Jasmine！

这个最简单的例子测试了src目录里面Player和Song这两个JavaScript类，测试用例代码位于spec目录中。

好吧，现在你还看不懂spec里面的那两个js文件到底在干嘛。为了能看懂，我们先来学一下Jasmine的基本语法。

快速掌握Jasmine语法

学习Jasmine记住四个核心的概念即可：分组、用例、期望、匹配。

四个核心概念分别对应Jasmine的四种函数，简要说明如下：

1、describe(string,function)这个函数表示分组，也就是一组测试用例。2、it(string,function)这个函数表示测试用例。3、expect(expression)表示期望expression这个表达式具有某个值或者具有某种行为。4、to***(arg)这个函数表示匹配。

对于同一组(describe)中的多个测试用例(it)，可以做一些重复性的动作，比如在每一个测试用例运行之前把某个变量+1等等。因此，Jasmine提供了beforeEach和afterEach两个函数，这也是为什么要有分组这个概念的原因。beforeEach和 afterEach的语法细节参见：http://pivotal.github.io/jasmine/

最简单的例子

describe("Group1", function() {   it("sample1", function() {       expect(true).toBe(true);   });})

我们期望布尔值true恒等于另一个布尔值true，显然，这个用例永远是正确的，测试一定会通过。

describe可以嵌套，并且里面可以放多个it，更细节的语法这里就不赘述了，请自行阅读前面的链接。

内置的匹配函数解析

在当前最新的版本中，Jasmine内置了15个匹配函数，列表如下：

toBe()toBeDefined()toBeUndefined()toBeNull()toBeTruthy()toBeFalsy()toEqual()toBeLessThan()toBeGreaterThan()toContain()toBeCloseTo()toHaveBeenCalled()toHaveBeenCalledWith()toMatch()toThrow()

仔细看看这些名字，能猜到它们想干嘛不？分别看一个例子：

expect(a).toBe(true);//期望变量a为trueexpect(a.foo).toBeDefined();//期望a.foo已定义expect(a.foo).toBeUndefined();//期望a.foo未定义expect(a).toBeNull();//期望变量a为nullexpect(a.isMale).toBeTruthy();//期望a.isMale为真expect(a.isMale).toBeFalsy();//期望a.isMale为假expect(true).toEqual(true);//期望true等于trueexpect(a).toBeLessThan(b);//期望a小于bexpect(a).toBeGreaterThan(b);//期望a大于b

toContain()用来检测数组中是否包含某个元素：

var a = ['foo', 'bar', 'baz'];expect(a).toContain('bar');

toBeCloseTo()这个函数需要稍稍解释一下，看例子：

var pi = 3.1415926, e = 2.78;expect(pi).not.toBeCloseTo(e, 2);expect(pi).toBeCloseTo(e, 0);

toBeCloseTo基本的功能是，把两个数按照指定的精度都进行四舍五入，然后比较是否相等。

第一个例子里面有一个not，表示否定的意思（类似地，not可以加到任何一个匹配函数之前来表示否定）。变量pi保留两位小数是3.14，2.78保留两位小数还是2.78，因此不相等，第一个expect通过。

第二个例子，pi只保留整数，为3；而2.78只保留整数（四舍五入）之后也为3，因此相等，所以第二个expect也通过。

toHaveBeenCalled()

expect(user.setName).toHaveBeenCalled();

期望user.setName这个方法已经被调用过。

toHaveBeenCalledWith()

expect(user.setName).toHaveBeenCalledWith("damoqiongqiu");

期望在调用user.setName这个方法的时候传递了"damoqiongqiu"这个参数。

toMatch()

expect(message).toMatch(/bar/);

用来对字符串进行正则匹配。

toThrow() expect(bar).toThrow();

用来匹配某个方法是否会抛出异常。

关于匹配函数的更多细节，参见官方文档：https://github.com/pivotal/jasmine/wiki/Matchers

自定义匹配函数

我们可以自己定义匹配函数，请看一个最简单的例子。

beforeEach(function() {  this.addMatchers({    toBeLessThan: function(expected) {      var actual = this.actual;      var notText = this.isNot ? " not" : "";      this.message = function () {        return "Expected " + actual + notText + " to be less than " + expected;      }      return actual < expected;    }  });});

将以上代码写到一个describe内部，就定义了一个toBeLessThan匹配函数。

this.actual表示实际值；expected表示期望的值；this.message表示运行时输出的信息；函数必须返回一个布尔值，true表示测试通过，false表示测试失败。

测试异步调用

describe("Asynchronous specs", function() {  var value, flag;  it("should support async execution of test preparation and exepectations",      function() {        runs(function() {          flag = false;          value = 0;          setTimeout(function() {            flag = true;          }, 500);        });        waitsFor(function() {          value++;          return flag;        }, "The Value should be incremented", 750);        runs(function() {          expect(value).toBeGreaterThan(0);        });    });});

第一个runs函数用来向服务器发起XHR请求；waitsFor函数用来等待，参数750表示超时时间，也就是说如果第一个runs函数超过750毫秒还没返回，测试失败。第二个runs函数表示请求成功返回之后需要执行的测试动作。

好了，对于编写测试用例来说，知道了以上内容已经足够了。

如果你是一个喜欢追究到底的人，可以直接打开jasmine.js和jasmine-html.js查看源码是怎么实现的。（PS:源码并不难，推荐阅读。）

为什么要集成Jasmine和JsTestDriver

前文说过，Jasmine本身不依赖于任何其它JS库，也不需要DOM结构。那为什么要把Jasmine和JSTD集成到一起使用呢？

核心原因是Jasmine的语法非常简单，写起来非常爽，相比之下，JSTD本身的那种语法写起来就比较啰嗦。

但是，JsTestDriver提供了Eclipse和IntelliJ插件，自动执行测试神马的比较方便。因此，把这两个人合在一起，互相取长补短。有男女搭配，干活不累的意思。

有人说，我不想瞎折腾，我就想单独使用JSTD!

Ok，fine，you are the BOSS! Go to hell man.

如何把Jasmine集成到JsTestDriver

请按照以下步骤操作：

第一步：下载一个适配器JasmineAdapter.js

https://github.com/ibolmo/jasmine-jstd-adapter/tree/master/src

把这份JS文件放到WebContent中的任意目录下。

第二步：修改JSTD的配置文件

load:  - jasmine/jasmine.js  - jasmine/jasmine-html.js  - jasmine-adapter/JasmineAdapter.js  - js/*.js  - js-test/*.js

注意，保持这个顺序不要改动。其它js源文件和测试用例文件，请修改成你本地的目录名称。

第三步：编写Jasmine测试用例代码，放到js-test目录下，然后就开始运行JsTestDriver了，具体的运行方式参见上一篇。

一些问题

1、由于JSTD对中文的支持不太好，因此在写测试用例的时候最好全部使用E文。

2、测FireFox的时候，内存用量比较大，长时间运行会出现卡的现象。因此，开发过程中最好用IE一直开着运行，等完成之后再和其它浏览器一起测试。

下一篇预告：如何使用Jasmine+JsTestDriver对Angular进行单元测试

其它相关内容：

1、OReilly的《AngularJS》已经翻译完成，即将由电子工业出版社出版

http://damoqiongqiu.iteye.com/blog/1909041

2、《AngularJS》5个实例详解Directive（指令）机制

http://damoqiongqiu.iteye.com/blog/1917971

3、AngularJS表单基础

http://damoqiongqiu.iteye.com/blog/1920191

4、AngularJS Form 进阶：远程校验和自定义输入项

http://damoqiongqiu.iteye.com/blog/1920993

5、AngularJS：在Windows上安装Yeoman

http://damoqiongqiu.iteye.com/blog/1885371

6、对比Angular/jQueryUI/Extjs：没有一个框架是万能的

http://damoqiongqiu.iteye.com/blog/1922004

7、使用JsTestDriver实现JavaScript单元测试

http://damoqiongqiu.iteye.com/blog/1924415

1 楼 llllmnglf 前天莫老师牛逼啊！顶起！~

热点排行