Friday, 21 March 2008

grails-jsunit-0.1

This information is out of date - please see http://www.grails.org/jsUnit+plugin


grails-jsunit provides an easy and convenient way to utilize the JsUnit framework to your grails application. JsUnit allows you to unit test JavaScript functions in a similar way to using JUnit for Java.

To install the plugin, use:

grails install-plugin http://www.javathinking.com/grails/grails-jsunit-plugin/0.1/grails-jsunit-0.1.zip

This plugin adds the following new scripts:

create-jsunit-test
Generates a new empty jsunit test. Supply the path of the test you want to create, relative to 'test/jsunit/tests'.
Example use:
grails create-jsunit-test registration/mytest

creates
${basedir}/test/jsunit/tests/registration/mytest.html


run-jsunit
Runs JsUnit in the specified browser. Specify the path to your browser as a command line parameter i.e.
grails run-jsunit /usr/bin/firefox

or, if the executable is on the path you would just need
grails run-jsunit firefox


In your application.properties, you can specify:
jsunit.autoRun=true


When executing this script, it overwrites ${basedir}/test/jsunit/suiteAll.html to build a suite that references all tests in ${basedir}/test/jsunit/test.