Test Suites

JsUnit supports Test Suites. A Test Suite is a collection of Test Pages; a common use of Test Suites is to group Test Pages which test related areas. In JsUnit, a Test Suite is a special kind of Test Page which lists Test Pages and/or other Test Suites; if one runs the Test Suite Page in the Test Runner, each Test Page listed is run in succession. The Test Pages listed in a suite can themselves be Test Suite pages. In this way we can have one "master" Test Suite Page which runs a large number of grouped tests (just as things are in JUnit).

To define a Test Suite Page in JsUnit, make a function called "suite()" in a Test Page (note that the Test Page should itself contain no tests). This function should return a JsUnitTestSuite object. The methods on the JsUnitTestSuite type are listed below. See the tests/jsUnitTestSuite.html Test Suite file for an example.

• addTestPage(filename) adds a Test Page to the suite. The filename parameter is the fully qualified or relative URL of the Test Page, for example "file:///mytests/testPage.html" or "../testPage.html". If relative, it is relative to testRunner.html.
• addTestSuite(aTestSuite) adds a Test Suite to the suite. aTestSuite must be an object of type JsUnitTestSuite and be declared in the same page as the suite function.