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