JsUnit详解——《ajax基础》笔记（二）
使用标准/定制查询串
如此说来，测试运行工具是很强大的，但是每天都得打开这个测试运行工具，并浏览你的测试页或测试集，这可能非常烦人。好在可以使用一些查询串来预置要运行的文件，让测试运行工具自动地运行测试，甚至可以向测试传递参数 ！测试运行工具支持testPage 查询串 。在浏览器地址栏中键入以下地址（当然，根据具体环境可能要做相应调整），就会在浏览器中启动测试运行工具，并且预置了给定的测试：
file:///E:/jsunit2.2/jsunit/testRunner.html?testPage=E:/jsunit2.2/testSuit.html
你会看到测试运行工具运行了起来，你传递给testPage的实参会显示在file（文件）框中，如下图所示。注意，现在没有Browse（浏览）按钮了，因为你已经告诉测试运行工具要运行什么，它已经知道了。
当然，聪明的开发人员可能会对经常运行的测试集建立书签。如果你觉得testPage还不错，可能还想让autoRun 试试身手！顾名思义，可以结合autoRun和testPage来加载你最喜欢的测试页或测试集，然后它们会自动地运行，不需要再点上面的那个run按钮了。这样一个示例查询串如下所示：
file:///E:/jsunit2.2/jsunit/testRunner.html?testPage=E:/jsunit2.2/testSuit.html&autoRun=true
你应该能看到一个漂亮的绿条（见下图）。注意这里有Run按钮，因此，你可以很轻松地重新运行你的测试。同样地，能干的程序员很可能在浏览器上为这个查询增加书签。
你可能认为开发人员只需要testPage和autoRun，但实际上还不只如此！在后台，测试运行工具会把各个测试页增加到一个不可见的帧（Frame）。大多数情况下这样是可以的，但是如果有些代码必须在一个可见的帧中运行，而且你使用的是IE ，就可以告诉测试运行工具要在一个可见帧中显示你的页面。如果在查询串中加入了showTestFrame ，JsUnit就会在一个可见的帧中显示你的页面。如果你输入了showTestFrame=true ，测试页会在一个默认高度的帧中显示。如果这个默认值不合适，可以传入一个整数值，将帧高度指定为参数值（以像素为单位）。
有时，你可能想向测试页或测试集传递特定的值。可以在查询串中增加任意的行参/实参对，在测试页或测试集中使用top.jsUnitParmHash.parameterName 或top.jsUnitParmHash['parameterName'] 来获取这些值。假设按以下路径打开测试运行工具：file:/// Users/nate/projects/chapter6/web/jsunit/testRunner.html?key=1，就可以使用top.jsUnitParmHash.key或top.jsUnitParmHash['key']来访问参数key。如果你只想运行某些测试，这就很有用。下面代码清单显示了一个复杂的例子。
customSuit.html代码清单：
<html>
<head>
<title>Sample Test Suite</title>
<script language="JavaScript" src="jsunit/app/jsUnitCore.js"></script>
<script language="JavaScript">
function sampleSuite() {
var suiteToRun = top.jsUnitParmHash.suite;
var sampleSuite = new top.jsUnitTestSuite();
if(suiteToRun == "setUptearDownTest") {
sampleSuite.addTestPage("../setUptearDownTest.html");
}
sampleSuite.addTestPage("../smimpleTest.html");
sampleSuite.addTestPage("../setUpPageTest.html");
return sampleSuite;
}
function suite() {
var testSuite = new top.jsUnitTestSuite();
testSuite.addTestSuite(sampleSuite());
testSuite.addTestPage("../exposeTest.html");
return testSuite;
}
</script>
</head>
<body>
This is a simple test suite that uses custom queries.
</body>
</html>
可以想见，在测试运行工具中为路径追加?suite=setUptearDownTest，这会导致运行setUptearDownTest.html测试页，如果没有，则不会运行。
尽管这显然是一个简单的例子，但是从中可以看出，在不同场合下，使用定制参数来运行测试集或测试页是非常有用的。当然，你可能想为浏览器的书签文件夹增加这些特殊的查询串，以便以后使用。
还有一个有意思的标准参数是debug。不要把这个参数与debug 跟踪级别混为一谈，它们完全不同。debug参数会在使用JsUnit的开发工作中用到。对于这个查询串，你可能不会做太多工作，但是如果你很好奇，可以知道有这样一个参数（如下图）。
file:///E:/jsunit2.2/jsunit/testRunner.html?testPage=E:/jsunit2.2/customSuit.html&autoRun=true&suite=setUptearDownTest&debug 
另外还有两个标准参数，只有与JsUnit服务器结合时才有意义：submitResults 和resultId 。我们稍后会讨论JsUnit服务器，到时你会更清楚地了解这两个参数，不过要知道，在测试运行工具的浏览器路径中增加submitResults=true，这会告诉JsUnit：将测试的结果发送到JsUnit的“acceptor” servlet 。这对你意味着什么？使用这个参数的话，测试运行的结果会创建结果的一个XML表示（与JUnit的XML输出有同样的结构），以便以后获取。如果向浏览器输入 file:///E:/jsunit2.2/jsunit/testRunner.html?testPage=E:/jsunit2.2/customSuit.html&autoRun=true&suite=setUptearDownTest&debug&submitResults=true 连接（注：默认会发往本机JsUnit，如果是其他服务器，则把submitResults设置成localhost:8080/jsunit/acceptor的形式即可），则测试完成后会把测试结果发送到JsUnit服务器，然后服务器根据测试传过来的结果生成XML格式的结果，并显示在浏览器中。要想看到以下结果，则还要把JsUnit服务启动起来，我这里是用的Ant命令直接拉起来的，拉起的过程图也在下面：
只有当使用submitResults=true时，resultId查询才有意义。我们只对JsUnit服务器的工作稍提及，根据我们介绍的这一点点内容，你可能可以猜出：提交到JsUnit服务器的各个测试应该有各自惟一的标识符。可以让JsUnit来提供自己的ID，但是如果必须使用你喜欢的编号，也可以通过resultId参数传递这样一个数。如果在地址栏中输入 file:///E:/jsunit2.2/jsunit/testRunner.html?testPage=E:/jsunit2.2/customSuit.html&autoRun=true&suite=setUptearDownTest&debug&submitResults=true&resultId=logfilename ，则生成的XML中id的值为logfilename，如果服务器保存了这个XML文件，则文件名也会包含logfilename。
使用JsUnit服务器
虽然向测试运行工具传递各种参数可以较容易地完成自动化测试，但是你很快就会厌倦这样以常规方式手工地运行测试（我们可以结合 ANT 与 JUnit 来完成全自动化测试 ，以及纳入持续集成管理），特别是要考虑到多个操作系统上的多个浏览器 时，更是如此。你可能想跟踪以前运行的结果 ，以便进行审计或完成质量保证。为解决这些问题，JsUnit服务器会提供测试结果的XML日志 ，从JUnit或Ant脚本运行测试，以及在远程主机上从JUnit或Ant脚本运行测试。
利用JsUnit服务器，你只需点击一个按钮或调用一下命令，就能基于你的操作系统/浏览器运行整个测试集。另外，只需在一个重要步骤中把JavaScript的测试增加到Ant脚本中，就能使之成为构建过程的一部分。JsUnit服务器包括一组Java servlet，它们在可嵌入的Jetty开源Web服务器上运行，这样你就无需在每个主机上都配置一个Web服务器/servlet容器（因为JsUnit本身就与Jetty集成了，运行时只需用Ant启动就行了） 。一旦完成配置，这个过程就很简单了，只是按下一个按钮或调用一下命令而已！
配置服务器
在利用JsUnit服务器之前，需要先进行配置。为此可以修改build.xml文件，这个文件在jsunit文件夹中。这个文件的最前面有一组属性，可以修改这些属性来满足你的需要。这些变量都很好理解，详细内容请见下表。
服务器配置
| 环境变量 |
内 容 |
| browserFileNames |
你想测试的一组浏览器可执行文件，这是一个完全路径列表，各个路径之间用逗号分隔 |
| url |
测试运行工具的 URL ，包括适当的查询串来自动运行适当的测试集 |
| port |
运行 JsUnit 服务器的端口，如果没有这个变量，会就使用端口 8080 |
| resourceBase |
定义 JsUnit 服务器的文档根。如果是空值（一般设置），就会使用 jsunit 安装目录 |
| logsdirectory |
运行测试的结果会写到这个目录。如果是空值，则默认为 jsunit/logs |
| remoteMachineURLs |
指定你想在哪些远程主机上运行测试，即这些远程主机的 URL 列表，各 URL 之间用逗号分隔。这些远程主机需要已经安装配置了一个 JsUnit 服务器 |
一旦配置了测试集（或测试页）和浏览器组合，只需运行standalone_test 目标。我配置以下三个属性
<property
name="browserFileNames"
value="C:\Program Files\Internet Explorer\iexplore.exe"
description="browserFileNames is the list of browsers in which to run tests when StandaloneTest is invoked on this machine. For a JsUnit Server, this is a mandatory property. For example: 'c:\program files\internet explorer\iexplore.exe,c:\program files\netscape\netscape7.1\netscp.exe'"
/>
<property
id="closeBrowsersAfterTestRuns"
name="closeBrowsersAfterTestRuns"
value="false"
description="closeBrowsersAfterTestRuns determines whether to attempt to close browsers after test runs. This is not a mandatory property. The default is true. For example: 'true'"
/>
<property
id="url"
name="url"
value="file:///E:/jsunit2.2/jsunit/testRunner.html?testPage=E:/jsunit2.2/customSuit.html"
description="url is the URL (HTTP or file protocol) to open in the browser. For a JsUnit Server, this is a mandatory property for a test run if the server is not passed the 'url' parameter. For example: 'file:///c:/jsunit/testRunner.html?testPage=c:/jsunit/tests/jsUnitTestSuite.html'"
/>
运行这个目标，会在你指定的端口上启动Jetty服务器，而一旦服务器开始运行，就会启动你指定的浏览器，而且会运行你配置的测试。当然，不必特别注意结果，如果出现一个失败或错误，它会显示在Ant任务的输出中，指出任务失败。
在命令行运行结果如下：
E:\jsunit2.2\jsunit>ant standalone_test
Buildfile: build.xml
standalone_test:
[junit] Testsuite: net.jsunit.StandaloneTest
[junit] 2009-10-20 21:37:59 org.mortbay.util.FileResource <clinit>
[junit] 信息: Checking Resource aliases
[junit] 2009-10-20 21:37:59 com.opensymphony.webwork.config.DefaultConfigura
tion <init>
[junit] 警告: Could not find webwork.properties
[junit] 2009-10-20 21:38:01 net.jsunit.AbstractJsUnitServer logStatus
[junit] 信息: Starting Standard Server with configuration:
[junit] <configuration type="STANDARD">
[junit] <os>x86 - Windows XP</os>
[junit] <ipAddress>192.168.1.100</ipAddress>
[junit] <hostname>192.168.1.100</hostname>
[junit] <browserFileNames>
[junit] <browserFileName id="0">C:\Program Files\Internet Explorer\iexpl
ore.exe</browserFileName>
[junit] </browserFileNames>
[junit] <closeBrowsersAfterTestRuns>false</closeBrowsersAfterTestRuns>
[junit] <description />
[junit] <logsDirectory>E:\jsunit2.2\jsunit\logs</logsDirectory>
[junit] <port>8080</port>
[junit] <resourceBase>E:\jsunit2.2\jsunit\.</resourceBase>
[junit] <timeoutSeconds>60</timeoutSeconds>
[junit] <url>file:/E:/jsunit2.2/jsunit/testRunner.html?testPage=E:/jsunit2
.2/customSuit.html</url>
[junit] </configuration>
[junit] 2009-10-20 21:38:01 org.mortbay.http.HttpServer doStart
[junit] 信息: Version Jetty/5.1.10
[junit] 2009-10-20 21:38:02 org.mortbay.util.Container start
[junit] 信息: Started org.mortbay.jetty.servlet.ServletHandler@1d7ad1c
[junit] 2009-10-20 21:38:02 org.mortbay.util.Container start
[junit] 信息: Started ServletHttpContext[/jsunit,/jsunit]
[junit] 2009-10-20 21:38:02 org.mortbay.http.SocketListener start
[junit] 信息: Started SocketListener on 0.0.0.0:8080
[junit] 2009-10-20 21:38:02 org.mortbay.util.Container start
[junit] 信息: Started org.mortbay.http.HttpServer@1f6f0bf
[junit] 2009-10-20 21:38:03 net.jsunit.AbstractJsUnitServer logStatus
[junit] 信息: Starting Test Run
[junit] 2009-10-20 21:38:03 net.jsunit.AbstractJsUnitServer logStatus
[junit] 信息: Launching C:\Program Files\Internet Explorer\iexplore.exe on f
ile:/E:/jsunit2.2/jsunit/testRunner.html?testPage=E:/jsunit2.2/customSuit.html&a
utoRun=true&submitResults=localhost:8080/jsunit/acceptor
[junit] 2009-10-20 21:38:03 net.jsunit.AbstractJsUnitServer logStatus
[junit] 信息: Waiting for C:\Program Files\Internet Explorer\iexplore.exe to
submit result
[junit] 2009-10-20 21:38:11 com.opensymphony.xwork.interceptor.component.Com
ponentInterceptor <clinit>
[junit] 信息: WebWork's IoC has been deprecated, please use an alternative s
uch as Spring
[junit] 2009-10-20 21:38:11 net.jsunit.AbstractJsUnitServer logStatus
[junit] 信息: Received submission
[junit] 2009-10-20 21:38:12 net.jsunit.AbstractJsUnitServer logStatus
[junit] 信息: Test Run Completed
[junit] 2009-10-20 21:38:12 net.jsunit.AbstractJsUnitServer logStatus
[junit] 信息: Stopping server
[junit] 2009-10-20 21:38:12 org.mortbay.util.ThreadedServer$Acceptor run
[junit] 信息: Stopping Acceptor ServerSocket[addr=0.0.0.0/0.0.0.0,port=0,loc
alport=8080]
[junit] 2009-10-20 21:38:12 org.mortbay.http.SocketListener stop
[junit] 信息: Stopped SocketListener on 0.0.0.0:8080
[junit] 2009-10-20 21:38:12 org.mortbay.util.Container stop
[junit] 信息: Stopped org.mortbay.jetty.servlet.ServletHandler@1d7ad1c
[junit] 2009-10-20 21:38:13 org.mortbay.util.Container stop
[junit] 信息: Stopped ServletHttpContext[/jsunit,/jsunit]
[junit] 2009-10-20 21:38:13 org.mortbay.util.Container stop
[junit] 信息: Stopped org.mortbay.http.HttpServer@1f6f0bf
[junit] Tests run: 1, Failures: 0, Errors: 0, Time elapsed: 13.953 sec
[junit] ------------- Standard Error -----------------
[junit] 2009-10-20 21:37:59 org.mortbay.util.FileResource <clinit>
[junit] 信息: Checking Resource aliases
[junit] 2009-10-20 21:37:59 com.opensymphony.webwork.config.DefaultConfigura
tion <init>
[junit] 警告: Could not find webwork.properties
[junit] 2009-10-20 21:38:01 net.jsunit.AbstractJsUnitServer logStatus
[junit] 信息: Starting Standard Server with configuration:
[junit] <configuration type="STANDARD">
[junit] <os>x86 - Windows XP</os>
[junit] <ipAddress>192.168.1.100</ipAddress>
[junit] <hostname>192.168.1.100</hostname>
[junit] <browserFileNames>
[junit] <browserFileName id="0">C:\Program Files\Internet Explorer\iexpl
ore.exe</browserFileName>
[junit] </browserFileNames>
[junit] <closeBrowsersAfterTestRuns>false</closeBrowsersAfterTestRuns>
[junit] <description />
[junit] <logsDirectory>E:\jsunit2.2\jsunit\logs</logsDirectory>
[junit] <port>8080</port>
[junit] <resourceBase>E:\jsunit2.2\jsunit\.</resourceBase>
[junit] <timeoutSeconds>60</timeoutSeconds>
[junit] <url>file:/E:/jsunit2.2/jsunit/testRunner.html?testPage=E:/jsunit2
.2/customSuit.html</url>
[junit] </configuration>
[junit] 2009-10-20 21:38:01 org.mortbay.http.HttpServer doStart
[junit] 信息: Version Jetty/5.1.10
[junit] 2009-10-20 21:38:02 org.mortbay.util.Container start
[junit] 信息: Started org.mortbay.jetty.servlet.ServletHandler@1d7ad1c
[junit] 2009-10-20 21:38:02 org.mortbay.util.Container start
[junit] 信息: Started ServletHttpContext[/jsunit,/jsunit]
[junit] 2009-10-20 21:38:02 org.mortbay.http.SocketListener start
[junit] 信息: Started SocketListener on 0.0.0.0:8080
[junit] 2009-10-20 21:38:02 org.mortbay.util.Container start
[junit] 信息: Started org.mortbay.http.HttpServer@1f6f0bf
[junit] 2009-10-20 21:38:03 net.jsunit.AbstractJsUnitServer logStatus
[junit] 信息: Starting Test Run
[junit] 2009-10-20 21:38:03 net.jsunit.AbstractJsUnitServer logStatus
[junit] 信息: Launching C:\Program Files\Internet Explorer\iexplore.exe on f
ile:/E:/jsunit2.2/jsunit/testRunner.html?testPage=E:/jsunit2.2/customSuit.html&a
utoRun=true&submitResults=localhost:8080/jsunit/acceptor
[junit] 2009-10-20 21:38:03 net.jsunit.AbstractJsUnitServer logStatus
[junit] 信息: Waiting for C:\Program Files\Internet Explorer\iexplore.exe to
submit result
[junit] 2009-10-20 21:38:11 com.opensymphony.xwork.interceptor.component.Com
ponentInterceptor <clinit>
[junit] 信息: WebWork's IoC has been deprecated, please use an alternative s
uch as Spring
[junit] 2009-10-20 21:38:11 net.jsunit.AbstractJsUnitServer logStatus
[junit] 信息: Received submission
[junit] 2009-10-20 21:38:12 net.jsunit.AbstractJsUnitServer logStatus
[junit] 信息: Test Run Completed
[junit] 2009-10-20 21:38:12 net.jsunit.AbstractJsUnitServer logStatus
[junit] 信息: Stopping server
[junit] 2009-10-20 21:38:12 org.mortbay.util.ThreadedServer$Acceptor run
[junit] 信息: Stopping Acceptor ServerSocket[addr=0.0.0.0/0.0.0.0,port=0,loc
alport=8080]
[junit] 2009-10-20 21:38:12 org.mortbay.http.SocketListener stop
[junit] 信息: Stopped SocketListener on 0.0.0.0:8080
[junit] 2009-10-20 21:38:12 org.mortbay.util.Container stop
[junit] 信息: Stopped org.mortbay.jetty.servlet.ServletHandler@1d7ad1c
[junit] 2009-10-20 21:38:13 org.mortbay.util.Container stop
[junit] 信息: Stopped ServletHttpContext[/jsunit,/jsunit]
[junit] 2009-10-20 21:38:13 org.mortbay.util.Container stop
[junit] 信息: Stopped org.mortbay.http.HttpServer@1f6f0bf
[junit] ------------- ---------------- ---------------
[junit]
[junit] Testcase: C:\Program Files\Internet Explorer\iexplore.exe took 13.95
3 sec
BUILD SUCCESSFUL
Total time: 14 seconds
E:\jsunit2.2\jsunit>
运行后会在jsunit/logs目录下生成日志文件，如下图：
上图中的文件名由resultid 与 browserId 组成，前一个红框为resultid，后一个为浏览器ID（比如browserFileNames属性配置了多个浏览器时就会从0开始编号）。
日志文件采用JUnit结果同样的XML格式，所以像自动化JUnit测试集一样，可以用同样的转换很容易地加以处理。可以直接查看XML文件，也可以使用JsUnit内置的“displayer”servlet。
要使用“displayer”servlet，首先确保JsUnit服务器已经运行。如果未运行，只需运行start_server目标。一旦JsUnit服务器开始运行，打开你最喜欢的浏览器，指向localhost:8080/jsunit/displayer?id=×××&browserId=0，这里的×××是你想查看的结果日志的ID，后一个x为浏览器ID。如果你想看上面那个XML文件，可以在地址栏中输入 http://localhost:8080/jsunit/displayer?id=1256046869328&browserId=0 ，你会看到测试运行的结果，如下图所示。
在远程主机上运行测试
如果想在分布式主机上运行测试集，需要使用distributed_test Ant任务。当然，必须在要用的每个远程主机上配置一个JsUnit服务器，并配置适当的测试和浏览器。运行distributed_test Ant任务会调用一个JUnit测试（net.jsunit.DistributedTest），它会进一步在配置中提供的每个远程主机上调用一个servlet。这个servlet运行的基于JUnit的测试与本地运行的测试（net.jsunit.StandaloneTest）是一样的。然后，会在远程主机上配置的浏览器中运行测试，结果发送回发起者。
能过调用远程注机上的测试，这样就可以测试任何操作系统与浏览器的组合，并且可以以命令行方式执行所有的测试用例，然后我们就可以更进一步将对于JS代码的自动测试集成到持续集成工具（CC、AntHill、etc.）之中了。
附上这二节所用到的测试页 jsunitTest.rar ，我是放在与 jsunit同一目录下测试。