Since the Simulator uses Selenium RC to start the browser and run tests, the relevant sections from the Selenium documentation apply. Due to the special nature of qooxdoo applications, however, some browsers require additional configuration steps before they can be tested.
The 3.x line of Mozilla Firefox is usually the most reliable option for Simulator tests. Firefox 3.0, 3.5 and 3.6 are all known to work on Windows XP and 7 as well as Linux and OS X.
Firefox 4 is not supported by Selenium 1.0.3 out of the box, but it can be used for testing by starting it with a custom profile. These are the necessary steps:
"simulation-run" :
{
"environment" :
{
"simulator.testBrowser" : "*custom C:/Program Files/Mozilla Firefox/firefox.exe -P FF4-selenium",
[...]
}
}
When testing with IE, the Selenium server must be started with the -singleWindow option so the AUT will be loaded in an iframe. This is deactivated by default so two separate windows are opened for Selenium and the AUT. IE restricts cross-window JavaScript object access, causing the tests to fail.
java -jar selenium-server.jar -singleWindow -userExtension [...]
To launch IE, the *iexploreproxy launcher should be used. The *iexplore launcher starts the embedded version of IE which in some ways behaves differently from the full-blown browser.
"simulation-run" :
{
"environment" :
{
"simulator.testBrowser" : "*iexploreproxy",
[...]
}
}