Jump Start FitNesse with Selenium using Generic Fixture

Download FitNesse

Go to http://fitnesse.org/FitNesse.DownLoad and download the the “Full Distribution (fitnesse200#####.zip)”. Unpack the zip into c:\program files. Once extracted you must have a directory c:\program files\fitnesse.

Download Selenium Remote Control

Go to http://selenium-rc.openqa.org/download.jsp and download the latest version (1.0-beta-1 at the time of writing this page). Unpack the zip into c:\program files. Once extracted you must have a directory c:\program files\selenium. Current version for Selenium-RC is 1.0-beta-1 and these instructions are written assuming you are using this version.

Create a smart start script

Copy and paste following script into a file called run.vbs under the directory “C:\Program Files\selenium\selenium-remote-control-1.0-beta-1\selenium-server-1.0-beta-1″. This script will start both FitNesse servers and Selenium remote control servers on their default ports 8000 and 4444 respectively. This script will ONLY start these processes if these processes are not running, so this script can be safely run any time.

PS: Please note that this script is starting Selenium in an experimental Proxy Injection Mode which lets you run your web test across multiple domains. If you don’t want to use this feature feel free to change this start script.

Function IsProcessRunning( strServer, strProcess )
   Dim Process, strObject
   IsProcessRunning = False
   strObject   = "winmgmts://" & strServer
   For Each Process in GetObject( strObject ).InstancesOf( "win32_process" )
       If UCase( Process.name ) = UCase( strProcess ) Then
           IsProcessRunning = True
           Exit Function
       End If
   Next
End Function

sServer = "."      ' "." for local machine
Set objShell = WScript.CreateObject("WScript.Shell")
Set objEnv = objShell.Environment("Process")

FitNesse = "java -cp fitnesse.jar fitnesse.FitNesse -p 8000"
If( IsProcessRunning( sServer, FitNesse ) = False ) Then
   objshell.CurrentDirectory  = "C:\program files\fitnesse"
   f = objshell.Run  ( FitNesse, 6, false )
End If

Selenium = "java -jar selenium-server.jar -browserSessionReuse -proxyInjectionMode"
If( IsProcessRunning( sServer, Selenium ) = False ) Then
   objshell.CurrentDirectory = _
"C:\program files\selenium\selenium-remote-control-1.0-beta-1\selenium-server-1.0-beta-1"
   result = objshell.Run  ( Selenium, 5, true )
End If

Wscript.Quit

Download and Install Generic Fixture

Just follow simple instructions at this page or just drop genericfixture.jar into “C:\Program Files\fitnesse” directory.
Copy selenium-java-client-driver.jar from “C:\program files\selenium\selenium-remote-control-1.0-beta-1\selenium-java-client-driver-1.0-beta-1″ to “C:\program files\fitnesse” directory.

Run startup script

Using Windows explorer go to the directory “C:\Program Files\selenium\selenium-remote-control-1.0-beta-1\selenium-server-1.0-beta-1″ and double click on the run.vbs. This will start 2 Java process in 2 separate command windows with Selenium window in normal and FitNesse window in minimized state.

Create a page on FitNesse for Google Web Test using Generic Fixture

1. Open your browser and goto the URL http://localhost:8000/FrontPage. Look for the Edit button on the left hand navigation column. If Edit button is not present then goto the URL http://localhost:8000/FrontPage?properties and select the “Edit” check box and click on Save Properties. Now click on Edit button and once on the Edit Page add a new line at the end of all the text already there and save your changes.

   |[[Web Test Suites][FitNesse.SuiteWebTests]]|FitNesse’s suite of Web Tests|

2. Now on the Front Page it will display a text like “Web Test Suites?” with ? as hyper link. Click on ? link.
3. Once in the Edit Page copy paste following text into text area and save your changes:

   !*> Class Path & Global Defines
   !path selenium-java-client-driver.jar
   !path genericfixture.jar
   !define IE {*piiexplore}
   !define FF {*pifirefox}
   !define sel {selenium=}
   !define ds {com.thoughtworks.selenium.DefaultSelenium}
   !define host {localhost}
   !define port {4444}
   !define COLLAPSE_SETUP {true}
   !define COLLAPSE_TEARDOWN {true}
   *!
   ----
   SuiteWebTests.SetUp
   SuiteWebTests.TearDown
   SuiteWebTests.GoogleTest

4. You will notice 3 ? links on the page. Now lets create each and every missing page.
5. Click on the ? link next to SuiteWebTests.SetUp text and on the “Edit Page” text area copy-paste following code an save your changes.

   !| DSL Adapter |
   | user types | % | into | % | field | type | {2}, {1} |
   | user starts the browser | start | |
   | users opens the URL | % | open | {1} |
   | page has the title | getTitle | |
   | user sees the text on the page | % | isTextPresent | {1} |
   | page has an element named | % | isElementPresent | {1} |
   | page loads in less than | % | seconds | waitForPageToLoad | {1}000 |
   | page has URL | getLocation | |
   | user clicks on submit button | click | //button[@type='submit'] |
   | user clicks on the link named | % | click | link={1} |
   | user clicks on the button named | % | clickAt | {1},”" |
   | get text from element named | % | getText | xpath=id(’{1}’) |
   | user stops the browser | stop | |
   | add a key-value with key | % | and value | % | put | {1}, {2} |
   | get value for the key | % | get | {1} |
   | show | toString | |
   
   !|Generic Fixture|${sel}{ds}|${host}|${port}|${FF}|http://${host}|
   | user starts the browser |

6. Go back to the page: http://localhost:8000/FitNesse.SuiteWebTests
7. Click on the ? link next to SuiteWebTests.TearDown text and on the “Edit Page” text area copy-paste following code an save your changes.

   !| Generic Fixture | ${sel} |
   | user stops the browser |

8. Again go back to the page: http://localhost:8000/FitNesse.SuiteWebTests
9. Now click on ? link next to SuiteWebTests.GoogleTest text and on the “Edit Page” text area copy-paste following code an save your changes.

   !define q {fitnesse generic fixture}
   !| Generic Fixture | ${sel} |
   | users opens the URL | http://www.google.com |
   | page has the title | | Google |
   | page has an element named | q | | true |
   | page has an element named | btnG | | true |
   | user types | ${q} | into | q | field |
   | user clicks on the button named | btnG |
   | page loads in less than | 5 | seconds |
   | page has the title | | ${q} - Google Search |
   | user clicks on the link named | Next |
   | page loads in less than | 5 | seconds |
   | user clicks on the link named | Next |
   | page loads in less than | 5 | seconds |
   | user sees the text on the page | Results 21 - 30 | | true |

10. After saving your changes click on Properties button from the left hand navigation menu and click on check box left to Test property and save your changes. Now you should see Test button on the top of the lest navigation menu.

Execute your Google Web Test Page on FitNesse using Selenium

Just click on the Test click on this page: http://localhost:8000/FitNesse.SuiteWebTests.GoogleTest and watch the magic of web test being run. Test will open a new Firefox browser and go to www.google.com and search Google with query text “fitnesse generic fixture”
Upon completion of test you should see this on the top of the results page:

Assertions: 5 right, 0 wrong, 0 ignored, 0 exceptions

Optional but Recommended Installations

You are all set to to write your test tables in FitNesse.

However if you are doing web testing using Selenium, there are two very handy add-ons for Firefox that will be extremely useful for writing web tests:

1. XPath Checker: Download it from https://addons.mozilla.org/en-US/firefox/addon/1095
2. Selenium IDE: Download it from http://selenium-ide.openqa.org/download.jsp