Selenium RC Configuration

Last updated by fletcherr 2 years ago

Configuration

Installing the plugin should create an empty configuration file in grails-app/conf/SeleniumConfig.groovy that can be customised according to your requirements. Configuration values are:

Config Key	Description	Default
selenium.slowResources	If set to true the Selenium tests will run slowly.	false
selenium.singleWindow	If false Selenium will run in multiple windows which can be useful if your app has frame escape code. Note: this config value is ignored when selenium.browser is iexplore or safari as certain modes do not work with those browsers.	true unless browser is Internet Explorer.
selenium.host	The host the Selenium Server will run on.	localhost
selenium.port	The port the Selenium Server will run on.	4444
selenium.browser	The browser Selenium will use.	firefox on Linux, safari on OSX, *iexplore on Windows
selenium.url	The base URL where the tests will be run.	The Grails server URL (grails.serverURL in the application config)
selenium.defaultTimeout	The timeout in milliseconds that Selenium will use when waiting for a page to load or using the waitFor method	60000
selenium.windowMaximize	If set to true the browser window will be maximized when opened. This has no effect in single window mode.	false

Environment specific configuration can be included in SeleniumConfig.groovy just as it can in Grails' regular Config.groovy file. For example:

selenium {
    host = "localhost"
    port = 1234
}
environments {
    test {
        selenium.host = "my.host.bv"
        selenium.port = 5678
    }
}

Using System Properties

All configuration values can be overridden using system properties. This is probably most useful for overriding the browser used on individual developers' machines or on continuous integration environments without affecting the project-wide settings. For example to run Selenium tests using Firefox instead of your platform's default browser you can use grails -Dselenium.browser=*firefox test-app directly on the command line. To make such settings permanent on an individual machine add the required settings to the JAVA_OPTS environment variable. For example, add export JAVA_OPTS="$JAVA_OPTS -Dselenium.browser=*firefox" to your ~/.profile file (on Windows environment variables are set in the Advanced tab of the System Properties window).