JavaScript单元测试框架JsUnit基本介绍和使用

XUnit framework

　　XUnit是一套标准化的独立于语言的概念和结构集合,用于编写和运行单元测试(Unit tests).

　　每一个语言都有一个用于单元测试的XUnit框架,比如Java有JUnit, C++有CppUnit, PHP有PHPUnit, Oracle SQL有UTPL/SQL.

JsUnit

　　JsUnit的官网: http://jsunit.net/

　　JsUnit遵循XUnit的一些惯例:

　　单元测试在JsUnit中叫做Test Functions.

　　Test Functions所在的HTML页面叫做Test Page.

　　一个Test Page是一个包含jsUnitCore.js的HTML页面. jsUnitCore.js提供了一些断言函数, 比如assertEquals(comment, arg1, arg2).

　　JsUnit支持setUp()和tearDown().

　　Test Suite Page声明了一个suite()函数,返回一个JsUnitTestSuite, 用来运行含多个测试的套件.

　　JsUnit的testRunner.html页运行Test Pages.

　　TestRunner页面可以运行在一个文件服务器或者web服务器上.

JUnit和JsUnit

JavaScript编码规范

　　由于JavaScript没有访问修饰符,所以通常在JavaScript中,不希望外界访问的成员和方法名以下划线开始.

　　这是一种编码规范,不是语言的规定,虽然外界仍然可以访问但是不推荐.

　　JsUnit测试函数要遵循的规则与JUnit3.8类似,比如说测试函数名以test开头等.

JsUnit基本使用实例

　　待测试的源代码:test1.js

  function add(num1, num2)
  {
    return num1 + num2;
  }
 
  function subtract(num1, num2)
  {
    return num1 - num2;
  }
 
  function multiply(num1, num2)
  {
    return num1 * num2;
  }
 
  function addNumbers()
  {
    var v1 = document.getElementById("value1").value;
    var v2 = document.getElementById("value2").value;
 
    v1 = parseInt(v1);
    v2 = parseInt(v2);
 
    var v3 = v1 + v2;
 
    document.getElementById("value3").value = v3;
  }

　　测试页面:test1.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
 <head>
  <title> New Document </title>
  <meta name="Generator" content="EditPlus">
  <meta name="Author" content="">
  <meta name="Keywords" content="">
  <meta name="Description" content="">
 
  <script type="text/javascript" src="..\jsunit2_2\jsunit\app\jsUnitCore.js"></script>
 
  <script type="text/javascript" src="test1.js"></script>
 
  <script type="text/javascript">
 
  var count = 0;
 
  // 此函数只执行一次（在页面加载后），类似于JUnit 4.x中的@BeforeClass
  // 注意：并没有与@AfterClass对应的函数存在
  function setUpPage()
  {
    alert('setUpPage Invoked');
 
    // 这行代码必须放在setUpPage函数的最后一行
    // 告诉JsUnit，setUpPage函数已经执行完毕
 
    setUpPageStatus = "complete";
  }
 
  // setUp run before every test function
  function setUp()
  {
    //alert(count++);    //JUnit若这样执行,count全是0,因为每一个测试方法都会生成新的测试对象;
                        //JsUnit会递增count, 因为都是在同一个页面里去执行,所以会基于原有的值
 
    //设定初始条件
    document.getElementById("value1").value = 2;
    document.getElementById("value2").value = 3;
  }
 
  // tearDown run after every test function
  function tearDown()
  {
    //alert("tearDown");
 
    //清理状态
    document.getElementById("value1").value = "";
    document.getElementById("value2").value = "";
    document.getElementById("value3").value = "";
  }
 
  // 以下为测试函数（Test Function）
 
  function testAdd()
  {
    var result = add(1, 2);
 
    assertEquals(3, result);
  }
 
  function testSubtract()
  {
    var result = subtract(1, 2);
 
    assertEquals(-1, result);
  }
 
  function testMultiply()
  {
    var result = multiply(1, 2);
 
    assertEquals(2,result);
  }
 
  function testAddNumbers()
  {
    addNumbers();
 
    assertEquals("5", document.getElementById("value3").value);
  }
 
  </script>
 
 </head>
 <body>
 
  <input type="text" id="value1"><br>
  <input type="text" id="value2"><br>
  <input type="text" id="value3"><br>
 
  <input type="button" value="Add" onclick="addNumbers();">
 
 </body>
</html>

　　使用JsUnit提供的测试运行器: testRunner.html, 加载测试页面,即可运行相关测试,并报告结果.

setUp()和tearDown()

　　setUp()在每一个测试方法运行之前运行;

　　tearDown()在每一个测试方法运行之后运行.

　　对于JsUnit来说, 其setUp()和tearDown()方法与JUnit的运行原理是不同的.

　　JUnit中的setUp()和tearDown()之间是没有关系的,也就是说不同的测试方法运行在不同的测试对象之中;

　　而JsUnit的各个测试函数是运行在同一个测试页面中,因此同一个页面中setUp()和tearDown()运行多次(每个测试函数之前和之后),会针对同一个变量进行操作.

setUpPage()

　　setUpPage()在测试页面加载时执行,每次运行只执行一次.

　　这个方法的末尾必须加上:

       setUpPageStatus = "complete";

　　表示setUpPage()执行完成,否则会提示setUpPage not completed, 从而无法执行测试用例.

测试套件Suite

　　JsUnitTestSuite定义在jsUnitCore.js中, JsUnitTestSuite代表多个JsUnit测试页面的套件,测试页面和测试套件都可以被加在套件中,即套件是可嵌套的.(组合模式).

　　JsUnitTestSuite的定义(见jsUnitCore.js):

/**
 * @class
 * A JsUnitTestSuite represents a suite of JsUnit Test Pages.  Test Pages and Test Suites can be added to a
 * JsUnitTestSuite
 * @constructor
 */
function JsUnitTestSuite() {
    /**
     * Declares that this object is a JsUnitTestSuite
     */
    this.isJsUnitTestSuite = true;
    /**
     * @private
     */
    this._testPages = Array();
    /**
     * @private
     */
    this._pageIndex = 0;
 
    for (var i = 0; i < arguments.length; i++) {
        if (arguments[i]._testPages) {
            this.addTestSuite(arguments[i]);
        } else {
            this.addTestPage(arguments[i]);
        }
    }
}

测试套件的使用例子1: test2.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
 <head>
  <title> New Document </title>
  <meta name="Generator" content="EditPlus">
  <meta name="Author" content="">
  <meta name="Keywords" content="">
  <meta name="Description" content="">
 
  <script type="text/javascript" src="..\jsunit2_2\jsunit\app\jsUnitCore.js"></script>
 
<script type="text/javascript">
 
//测试套件名一定为suite
function suite()
{
    var testSuite = new top.jsUnitTestSuite();
 
    // 增加的测试页面的路径是相对于测试运行器（testRunner.html）的路径
    // 而不是当前页面
    testSuite.addTestPage("../../jsUnit_code/test1.html");
    testSuite.addTestPage("../../jsUnit_code/test1.html");
    testSuite.addTestPage("../../jsUnit_code/test1.html");
 
    return testSuite; // 最后需要返回套件
}
</script>
 </head>
 
 <body>
 
 </body>
</html>

测试套件的使用例子2: test3.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
 <head>
  <title> New Document </title>
  <meta name="Generator" content="EditPlus">
  <meta name="Author" content="">
  <meta name="Keywords" content="">
  <meta name="Description" content="">
 
  <script type="text/javascript" src="..\jsunit2_2\jsunit\app\jsUnitCore.js"></script>
 
  <script type="text/javascript">
 
   // 自定义的测试套件
  function mySuite()
  {
    var testSuite = new top.jsUnitTestSuite();
 
    testSuite.addTestPage("../../jsUnit_code/test1.html");
    testSuite.addTestPage("../../jsUnit_code/test1.html");
    testSuite.addTestPage("../../jsUnit_code/test1.html");
 
    return testSuite;
  }
 
  function suite()
  {
    var testSuite = new top.jsUnitTestSuite();
 
    testSuite.addTestPage("../../jsUnit_code/test1.html"); // 在测试套件中加入页面
    testSuite.addTestSuite(mySuite()); // 在测试套件中加入测试套件
 
    return testSuite; // 记得返回套件
  }
 
  </script>
 
 </head>
 
 <body>
 
 </body>
</html>

参考资料

　　圣思园张龙老师Java Web培训视频教程: 60-62.

　　JsUnit官网: http://jsunit.net/