您的位置:知识库 » Web前端

Dojo单元测试框架DOH介绍

来源: InfoQ  发布时间: 2011-09-10 22:10  阅读: 1287 次  推荐: 0   原文链接   [收藏]  

  单元测试的重要性已毋须多言,无论是从保证软件开发质量,还是从节约软件后期维护成本来说,单元测试都是最佳实践。而在敏捷编程领域,随着TDD(测试驱动开发)被越来越多的开发者所接受,单元测试已经成为开发过程中举足轻重的一部分。

  编写单元测试离不开成熟的单元测试框架,由于JUnit框架的成功,Java开发者对于单元测试的接受程度非常高。而Web2.0前端开发的单元测试一直以来是一块不太受重视的领域,导致这个状况的有很多:前端开发中逻辑和界面耦合度高、Javascript的模块概念单薄、Javascript运行环境(浏览器)不统一等;最主要的原因是缺乏成熟的单元测试框架,用来支持Web开发的特性(Ajax,DOM等)以及Web前端的自动化单元测试,然而Dojo中的DOH工具改变了这个现象。

  DOH简介

  Dojo作为一个成熟的Javascript开发工具集,提供了强大的Javascript单元测试工具DOH(Dojo Objective Harness)。DOH主要是由Dojo的创始人Alex Russel主持开发,目的就是要针对Web前端开发者提供一个有如下特点的测试框架:

  1. 提供用户界面:JUnit中的红条测试失败、绿条测试通过,大家都已经很熟悉了,DOH也有类似的用户界面,用户在测试时更加一目了然;
  2. 平台无关:DOH并不依赖某种浏览器平台,甚至不依赖于浏览器;用户可以根据自己的需要在命令行进行Javascript的自动化单元测试;
  3. 支持Ajax:Ajax编程在Web前端开发中是必不可少的一环,DOH最有价值的一个特性就是支持Ajax的测试;
  4. 不只适合与于Dojo,可用于任何JavaScript程序的单元测试。

  本文将以Dojo1.6.1版本为例,介绍如何使用DOH编写测试用例。

  DOH初体验

  Dojo的核心库(dojo)、控件库(dijit)以及一部分的扩展库(dojox)都自带了比较完备的测试用例,所以在了解如何编写DOH测试用例之前,运行一下Dojo1.6版本中已有的测试,可以对DOH有个大致的了解。

  首先下载Dojo1.6.1,DOH测试框架就在dojo-release-1.6.1-src/util/doh文件夹下,其中runner.html页面就是基于浏览器的DOH测试用户界面。本文中的http服务器使用Apache2.2,有关Apache的配置可以参照这里,首先我们来运行一下最常被使用的dojo.query的测试用例。dojo.query的测试模块为test._base.query,在浏览器上运行DOH测试用例非常简单,只要一个url即可:http://localhost/dojo161/util/doh/runner.html?testModule=tests._base.query ,dojo161是在Apache中设置的虚拟路径,指向dojo-release-1.6.1-src目录;下图是test._base.query模块的测试结果:

  左边的是测试用例列表,可以看到test._base.query测试模块里含有两组测试用例:test.base.query和test.base.NodeList,同事还显示了该测试集消耗的时间,右边是测试用例的日志。与JUnit相同,绿色表示通过测试,而红色反之。

  这里需要重点介绍的的是testModule参数:DOH中的测试对象称为测试模块,测试模块中包含测试用例。DOH提供了两种载入测试模块的方式,一种是直接载入声明了名称的测试模块, 下面的代码声明了名为test._base.query的测试模块,包含两组用例:

dojo.provide("tests._base.query");
if(dojo.isBrowser){
doh.registerUrl(
"tests._base.query", dojo.moduleUrl("tests", "_base/query.html"),
60000);
doh.registerUrl(
"tests._base.NodeList", dojo.moduleUrl("tests", "_base/NodeList.html"), 60000);
}

  在测试模块没有直接提供模块名的情况下,DOH会将testModule参数作为路径载入该路径下的测试模块, 例如当testModule = tests._base的时候,DOH将载入tests/_base/下的测试模块,如test._base.query、test._base.html、test._base.store...等等。

  一个简单的DOH测试用例

  运行了Dojo自带的测试用例之后,想必大家对DOH有了初步的了解,不过仅仅运行Dojo自己的用例怎么会过瘾呢?接下来以一个简单的DOH测试用例作为例子,加深对DOH的理解。首先在dojo工具包的根目录下创建myTests文件夹,用来存放测试用例:

  之后在myTests文件夹下创建dojoTest.js,请注意模块名与文件路径相对应:

dojo.provide("myTests.dojoTest");
doh.register(
"easyTests", [
function javascriptTest(){
doh.assertEqual(Math.pow(
5, 3), 125);
doh.assertTrue(
123=="123");
doh.assertFalse(
99999999> Infinity);
}
]);

  上面的代码注册了一个叫easyTests的测试用例,现在这个用例里只有一个叫javascriptTest的测试。这里用到了DOH中的三个断言:doh.assertEqual、doh.assertTrue、doh.assertFalse,如果觉得断言函数名太长,DOH也提供了doh.is、doh.t、doh.f来代替前面三个断言。

  细心的读者可能已经注意到doh.register的第二个参数是个数组,所以在easyTests下还可以继续添加测试,这次我们来测试dojo.string的trim和rep方法:

dojo.provide("myTests.dojoTest");
dojo.require(
"dojo.string");
doh.register(
"easyTests", [
function javascriptTest(){
...
},
function dojoStringTest(t){
t.
is("text", dojo.string.trim(" text \n"));
t.
is("xyxyxy", dojo.string.rep("xy", 3));
}
]);

  在添加第二个测试之前需要先载入了dojo.string模块。在测试中除了assertEqual用is简写代替以外,doh也变成了t,这是因为测试函数的默认参数就是doh。

  在JUnit中,setUp和tearDown做了测试的初始化和结束清理工作。在DOH也支持这样编写方式:

dojo.provide("myTests.dojoTest");
dojo.require(
"dojo.string");
doh.register(
"easyTests", [
...,{
name:
"Test String Substitute",
_templateString:
"",
setUp: function(){
this._templateString ="Dojo ${0} released at ${1}";
},
runTest: function(t){
t.
is("Dojo 1.6.1 released at 2010/05/02",
dojo.string.substitute(this._templateString, ["1.6.1", "2010/05/02"]));
},
tearDown: function(){
this._templateString ="";
}
]);

  name 为该测试的名字;setUp 在 runTest 之前运行;tearDown 在 runTest 之后运行,runTests是该测试的主体。这里值得注意的是自定义变量_templateString,方便在setUp、runTests、tearDown中使用。

  好了,让DOH来运行一下这个测试模块,http://localhost/dojo161/util/doh/runner.html?testModule=myTests.dojoTest :

  与HTML集成的DOH测试用例

  上一节介绍的DOH测试用例是比较独立的,但是Javascript天生就是要与浏览器、DOM打交道的,比如DOM节点选取功能或拖拽功能的测试就不能独立于HTML之外。所以DOH测试用例也可以写在HTML文件里,直接对HTML做操作。接下来我们将编写一个含有DOH测试用例的HTML文件。

  在myTest目录下创建domQuery.html,首先导入必要的dojo.js和runner.js文件:

...
<script type="text/javascript" src="../dojo/dojo.js" djConfig="isDebug: true"></script>
<script type="text/javascript" src="../util/doh/runner.js"></script>
...

  然后在dojo.ready函数里注册测试用例,注册完毕后不要忘了调用doh.run()运行测试:

<script>
dojo.addOnLoad(
function(){
doh.register(
"domQueryTest", [
function testQueryByTag(){
doh.is(
2, dojo.query("span").length);
},
"doh.is('h3', dojo.query(':first-child', '_foo')[0].innerHTML)",
"doh.is(3, dojo.query('>', '_foo').length)",
...
]);
doh.run();
});
</script>

  对于非常简单的测试,如第二个和第三个测试,可以直接用string来表示;最后,添加一些测试用的HTML代码:

<body>
<div class="foo bar" id="_foo">
<h3>h3</h3>
<span id="foo"></span>
<span></span>
</div>
</body>

  完成的HTML文件并不能被DOH的UI直接使用,使用doh.registerUrl将HTML页面注册为测试用例,之后就是运行DOH的runner.html了。

dojo.provide("myTests.domQuery");
try{
doh.registerUrl(
"myTest.domQuery", dojo.moduleUrl("myTests", "domQuery.html"))
}
catch(e){}

  集成的DOH测试模块

  至此,您应该已经了解如何编写单个测试文件。编写测试用例并不困难,而当测试用例越来越多的时候,可以把相关的测试用例集成在一起进行测试,这样就提高了测试的自动化效率。集成测试用例非常简单:只要把已经声明的测试用例用dojo.require方法载入到一个模块文件,通常命名为module.js,当 dojo.require引入这些文件时,也注册了这些测试。

myTests/module.js

dojo.provide(
"myTests.module");
try{
dojo.require(
"myTests.dojoTest");
dojo.require(
"myTests.domQuery");
}
catch(e){}

  myTests.module包含了两组测试用例: