Automated jQuery tests with QUnit

Installation

(sudo) gem install jodosha-hanoi -s http://gems.github.com

Crash Course

hanoi # prepare the target directory rake test:js # run the tests

How To Use

Prepare the target directory, you can use one of the following options:

hanoi hanoi . hanoi /path/to/project

You need a valid Rake installation to run your tests:

rake test:js

You can specify to run the test against one or more browsers:

rake test:js BROWSERS=firefox,ie,safari

You can specify to run only certain tests:

rake test:js TESTS=path/to/first_test.js,path/to/second_test.js

You can combine both BROWSERS and TESTS configurations.

Structure

The hanoi executable will create the following structure:

Rakefile test/ javascript/ assets/ jquery.js testrunner.js testsuite.css example_test.js fixtures/ example_fixtures.html templates/ test_case.erb

Rakefile creates a fresh rakefile, you have to edit it according to your setup
test Hanoi creates it if missing, otherwise will choose between existing test or spec paths
javascript is the root directory of your tests
assets contains the jQuery and QUnit source file and a css. Place your assets in this directory, it’s mapped as root path /.
example_test.js is a sample of a real test case.
templates contains the template file for your tests. You shouldn’t edit it, if you don’t know the risk.
fixtures contains all the HTML fixtures, each file will be injected into the proper case.

By convention, your test/javascript folder should reflect the structure of your source directory, appending the _test.js suffix to each test case and the _fixtures.html to each fixture file.

Example:

src/ directory_a/ directory_b/ file_3.js file_2.js file_1.js test/ javascript/ directory_a/ directory_b/ file_3_test.js file_2_test.js file_1_test.js fixtures/ directory_a/ directory_b/ file_3_fixtures.html file_1_fixtures.html

You have probably noticed that file_2_fixtures.html is missing, this because fixtures are optional.

Browsers & Platforms

Platforms:

MacOS
Windows
Linux

Browsers:

Firefox
Safari
Internet Explorer
Opera
Konqueror

Acknowledgements

The Ruby libraries of Hanoi are a customization of the jsblib.rb, courtesy of the Prototype team.

Hanoi runs a customized version of QUnit, courtesy of the jQuery team.

Repository

git clone git://github.com/jodosha/hanoi.git