alloy-js-test-san

= JSTestSan

A JavaScript test runner to run JavaScript tests from the comfort of your terminal.

== Why?

Because we want to run tests in a real browser environment, in our case WebKit, but in the same fashion we run out other (Rails) unit tests.

And we want to write the tests in a way that we can easily run them on other browsers as well, you know, html and js… This way we can run the tests from the terminal during regular development but still test on other browsers by loading the html/js files manually.

== Install & Usage

$ sudo gem install alloy-js-test-san -s http://gems.github.com $ jstest path/to/a/unit_test.html

To automatically run your test see http://github.com/alloy/kicker/tree/master.

== Problems?

You betcha! (See the example.)

But these shouldn't likely be a typical use case, I hope. So it actually works quite well seeing how many tests pass ;) The one that does fail has to do with the fact that there's no window at all. I haven't yet tried if it will simply work with a NSWindow.

== Example:

This is the output of the regression tests which are the Prototype unit tests:

$ ./bin/jstest test/regression/prototype/unit/*_test.html ................................................................................................................................... .......F........................................................................................................................... ..............................................................................................

1) Failed:

testViewportDimensions (Unit test file | Dom | default template | 2009-04-11 15:28) [test/regression/prototype/unit/dom_test.html]: Failure: NOTE: YOU MUST ALLOW JAVASCRIPT TO RESIZE YOUR WINDOW FOR THIS TEST TO PASS expected: <50>, actual: <0> Failure: NOTE: YOU MUST ALLOW JAVASCRIPT TO RESIZE YOUR WINDOW FOR THIS TEST TO PASS expected: <50>, actual: <0>

Finished in 17.725139 seconds.

356 tests, 2246 assertions, 2 failures, 0 errors