From v2.6.x, JSPWiki uses Selenium to web-unit-test the web-application.
Here is a quick 'how-to' to help you run these tests.


!! What is Selenium

Selenium is a test tool for web applications. Selenium tests run directly in a browser, just as real users do. And they run in Internet Explorer, Mozilla and Firefox on Windows, Linux, and Macintosh. 
  
Download from [http://selenium-core.openqa.org/]

!! Instructions for Manual runs from the Selenium console, aka __Selenium Core__

__Selenium Core__ uses a unique mechanism which allows it to run on so many platforms. Written in pure JavaScript/DHTML, you copy Selenium Core tests directly into your your application webserver, allowing the tests to run in any supported browser on the client-side. Thus, you must have write access to the machine your web application server is running on to install Selenium Core.

First copy Selenium Core routines to your application webserver
* copy from {{/selenium_core_0/core/**}} to your {{<jspwiki-dir>/selenium/**}}

Then copy the Selenium Core Test examples to your application webserver
* copy from {{/selenium_core_0/tests/**}} to your {{<jspwiki-dir>/tests/**}}


When you now point your browser to {{~http://your-jspwiki-apps/selenium/TestRunner.html}}, 
you should see the Core Selenium testing console. The default test suite 
{{../tests/~TestSuite.html}} is ready to be run. You can run it to check whether your setup is ok.


Now run the JSPWiki webtests.

First copy the webtests to your application webserver.
* copy from {{<JSPWiki-source-dir>/tests/etc/selenium/tests/**}} to your {{<jspwiki-dir>/tests/**}}\\
  (if you want you can first make the {{./tests}} directory empty but that is not required)

Then run the tests:
** point your browser to {{~http://your-jspwiki-apps/selenium/TestRunner.html}}
** change the Test Suite input field to {{../tests/~JSPWikiTestSuite.html}}
** now you can run the full suite or any individual test 

Notes:
* make sure your browsers ''Locale'' is set to english; the current web-tests still contain some hard-coded
  english texts
* make sure you JSPWiki site is ''idle'': go to {{My Prefs}} and clear the user preferences and browser cookies before running the tests.


!! Instruction for Automated runs from an ant task

Under construction

Read the instructions from {{build.xml}} and issue following command from the unix prompt:
{{{
>> ant webtests
}}}