Document is at http://jsunit.berlios.de/maven2.html. It's too brief, especially following paragraph:
The type of the test suite, one of the following values:
- ALLTESTS
- Looks for a class AllTests derived from TestSuite and runs its suite.
- TESTSUITES
- Looks for all classes ending with TestSuite and that are derived from TestSuite and run their suites.
- TESTCASES
- Looks for all classes ending with TestCase and that are derived from TestCase and runs them (the default).
The problem is what "derived from" means and how to to that. I will show in detail how to use JsUnit plugin.
1) sample test file
Following is a dummy test file. It should be put into src/test/js.
var dummyobj = dummyobj || {};
function DummyTest(name) {
TestCase.call(this, name);
};
DummyTest.inherits(TestCase);
DummyTest.prototype.setUp = function() {
dummyobj.name = "Gerald";
};
DummyTest.prototype.tearDown = function() {
delete dummyobj.name;
};
DummyTest.prototype.testDummy = function() {
this.assertEquals('Gerald', dummyobj.name);
};
DummyTest is the test case.
It "inherits" from class TestCase. All of its functions whose name start with "test" will be tested.
2) Inherit implementation
Following is implementation of inherit borrowedfrom Shindig code. It can be put in a file inherit_implementation.js under directory src/main/js.
Function.prototype.inherits = function(parentCtor) {
function tempCtor() {};
tempCtor.prototype = parentCtor.prototype;
this.superClass_ = parentCtor.prototype;
this.prototype = new tempCtor();
this.prototype.constructor = this;
};
3) Pom.xml
<plugin>
<groupId>de.berlios.jsunit</groupId>
<artifactId>jsunit-maven2-plugin</artifactId>
<executions>
<execution>
<id>test</id>
<configuration>
<sourceDirectory>${basedir}/src/main/js</sourceDirectory>
<sources>
<source>inherit_implementation.js</source>
<source>file_to_be_tested.js</source>
</sources>
<testSourceDirectory>${basedir}/src/test/js</testSourceDirectory>
<testSuites>
<testSuite>
<name>SampleSuite</name>
<type>TESTCASES</type>
<includes>
<include>*/*test.js</include>
</includes>
</testSuite>
</testSuites>
</configuration>
<goals>
<goal>jsunit-test</goal>
</goals>
</execution>
</executions>
</plugin>
Resources
For some tests, you need to provide fake window object, XmlHttpRequest object, DOM objects, etc. Project env-js (site) is exactly designed for this purpose. It provides a simulated browser environment.
Posts
