selenium:start-server

Full name:

org.codehaus.mojo:selenium-maven-plugin:2.2:start-server

Description:

Start the Selenium server.

Attributes:

  • Requires a Maven project to be executed.
  • Since version: 1.0-beta-1.

Required Parameters

Name Type Since Description
background boolean 1.0-beta-1 Flag to control if we background the server or block Maven execution.
Default value is: false.
logFile File 1.0-beta-1 The file that Selenium server logs will be written to.
Default value is: ${project.build.directory}/selenium/server.log.
workingDirectory File 1.0-beta-1 Working directory where Selenium server will be started from.

Optional Parameters

Name Type Since Description
avoidProxy boolean 1.0-beta-3 By default, we proxy every browser request; set this flag to make the browser use our proxy only for URLs containing '/selenium-server'
Default value is: false.
browserSessionReuse boolean 1.0-beta-3 Stops re-initialization and spawning of the browser between tests.
Default value is: false.
browserSideLog boolean 1.0-beta-3 Enables logging on the browser side; logging messages will be transmitted to the server. This can affect performance.
debug boolean 1.0-beta-1 Enable the server's debug mode..
Default value is: false.
defaultUserExtensions String 1.0-beta-1 The file or resource to use for default user-extensions.js.
Default value is: org/codehaus/mojo/selenium/default-user-extensions.js.
defaultUserExtensionsEnabled boolean 1.0-beta-1 Enable or disable default user-extensions.js
Default value is: true.
displayPropertiesFile File 1.0-beta-1 The location of the file to read the display properties.
Default value is: ${project.build.directory}/selenium/display.properties.
ensureCleanSession boolean 1.0-beta-3 If the browser does not have user profiles, make sure every new session has no artifacts from previous sessions. For example, enabling this option will cause all user cookies to be archived before launching IE, and restored after IE is closed.
Default value is: false.
firefoxProfileTemplate File 1.0-beta-1 Normally a fresh empty Firefox profile is created every time we launch. You can specify a directory to make us copy your profile directory instead.
forcedBrowserMode String 1.0-beta-3 Sets the browser mode (e.g. "*iexplore" for all sessions).
logOutput boolean 1.0-beta-1 Enable logging mode.
Default value is: false.
nonProxyHosts String 1.0-rc-2 Configure the Selenium Server to use http.nonProxyHosts.
port int 1.0-beta-1 The port number of the server to connect to.
Default value is: 4444.
profilesLocation String 2.0 Specify the option profilesLocation to selenium. See selenium documentation
proxyHost String 1.0-rc-2 Configure the Selenium Server to use http.proxyHost.
proxyPort String 1.0-rc-2 Configure the Selenium Server to use http.proxyPort.
singleWindow boolean 1.0-rc-1 Puts you into a mode where the test web site executes in a frame. This mode should only be selected if the application under test does not use frames.
Default value is: false.
skip boolean 1.0-beta-2 Allows the server startup to be skipped.
Default value is: false.
systemProperties Map 2.0 List of System properties to pass to the selenium process.
timeout int 1.0-beta-1 Timeout for the server in seconds.
Default value is: -1.
trustAllSSLCertificates boolean 1.0-beta-3 Forces the Selenium proxy to trust all SSL certificates. This doesn't work in browsers that don't use the Selenium proxy.
Default value is: false.
trustStore File 1.0-beta-3 The location of the SSL trust-store.
trustStorePassword String 1.0-beta-3 The password for the SSL trust-store.
userExtensions String 1.0-beta-1 Location of the user-extensions.js to load into the server. If defaultUserExtensionsEnabled is true, then this file will be appended to the defaults.
verifyBrowser String 1.0-beta-1 Attempt to verify the named browser configuration. Must be one of the standard valid browser names (and must start with a *), e.g. *firefox, *iexplore, *custom.

Parameter Details

avoidProxy:

By default, we proxy every browser request; set this flag to make the browser use our proxy only for URLs containing '/selenium-server'
  • Type: boolean
  • Since: 1.0-beta-3
  • Required: No
  • Expression: ${avoidProxy}
  • Default: false

background:

Flag to control if we background the server or block Maven execution.
  • Type: boolean
  • Since: 1.0-beta-1
  • Required: Yes
  • Expression: ${background}
  • Default: false

browserSessionReuse:

Stops re-initialization and spawning of the browser between tests.
  • Type: boolean
  • Since: 1.0-beta-3
  • Required: No
  • Expression: ${browserSessionReuse}
  • Default: false

browserSideLog:

Enables logging on the browser side; logging messages will be transmitted to the server. This can affect performance.
  • Type: boolean
  • Since: 1.0-beta-3
  • Required: No
  • Expression: ${browserSideLog}

debug:

Enable the server's debug mode..
  • Type: boolean
  • Since: 1.0-beta-1
  • Required: No
  • Expression: ${debug}
  • Default: false

defaultUserExtensions:

The file or resource to use for default user-extensions.js.
  • Type: java.lang.String
  • Since: 1.0-beta-1
  • Required: No
  • Default: org/codehaus/mojo/selenium/default-user-extensions.js

defaultUserExtensionsEnabled:

Enable or disable default user-extensions.js
  • Type: boolean
  • Since: 1.0-beta-1
  • Required: No
  • Default: true

displayPropertiesFile:

The location of the file to read the display properties.
  • Type: java.io.File
  • Since: 1.0-beta-1
  • Required: No
  • Default: ${project.build.directory}/selenium/display.properties

ensureCleanSession:

If the browser does not have user profiles, make sure every new session has no artifacts from previous sessions. For example, enabling this option will cause all user cookies to be archived before launching IE, and restored after IE is closed.
  • Type: boolean
  • Since: 1.0-beta-3
  • Required: No
  • Expression: ${ensureCleanSession}
  • Default: false

firefoxProfileTemplate:

Normally a fresh empty Firefox profile is created every time we launch. You can specify a directory to make us copy your profile directory instead.
  • Type: java.io.File
  • Since: 1.0-beta-1
  • Required: No
  • Expression: ${firefoxProfileTemplate}

forcedBrowserMode:

Sets the browser mode (e.g. "*iexplore" for all sessions).
  • Type: java.lang.String
  • Since: 1.0-beta-3
  • Required: No
  • Expression: ${forcedBrowserMode}

logFile:

The file that Selenium server logs will be written to.
  • Type: java.io.File
  • Since: 1.0-beta-1
  • Required: Yes
  • Expression: ${logFile}
  • Default: ${project.build.directory}/selenium/server.log

logOutput:

Enable logging mode.
  • Type: boolean
  • Since: 1.0-beta-1
  • Required: No
  • Expression: ${logOutput}
  • Default: false

nonProxyHosts:

Configure the Selenium Server to use http.nonProxyHosts.
  • Type: java.lang.String
  • Since: 1.0-rc-2
  • Required: No
  • Expression: ${nonProxyHosts}

port:

The port number of the server to connect to.
  • Type: int
  • Since: 1.0-beta-1
  • Required: No
  • Expression: ${port}
  • Default: 4444

profilesLocation:

Specify the option profilesLocation to selenium. See selenium documentation
  • Type: java.lang.String
  • Since: 2.0
  • Required: No
  • Expression: ${profilesLocation}

proxyHost:

Configure the Selenium Server to use http.proxyHost.
  • Type: java.lang.String
  • Since: 1.0-rc-2
  • Required: No
  • Expression: ${proxyHost}

proxyPort:

Configure the Selenium Server to use http.proxyPort.
  • Type: java.lang.String
  • Since: 1.0-rc-2
  • Required: No
  • Expression: ${proxyPort}

singleWindow:

Puts you into a mode where the test web site executes in a frame. This mode should only be selected if the application under test does not use frames.
  • Type: boolean
  • Since: 1.0-rc-1
  • Required: No
  • Expression: ${singleWindow}
  • Default: false

skip:

Allows the server startup to be skipped.
  • Type: boolean
  • Since: 1.0-beta-2
  • Required: No
  • Expression: ${maven.test.skip}
  • Default: false

systemProperties:

List of System properties to pass to the selenium process.
  • Type: java.util.Map
  • Since: 2.0
  • Required: No

timeout:

Timeout for the server in seconds.
  • Type: int
  • Since: 1.0-beta-1
  • Required: No
  • Expression: ${timeout}
  • Default: -1

trustAllSSLCertificates:

Forces the Selenium proxy to trust all SSL certificates. This doesn't work in browsers that don't use the Selenium proxy.
  • Type: boolean
  • Since: 1.0-beta-3
  • Required: No
  • Expression: ${trustAllSSLCertificates}
  • Default: false

trustStore:

The location of the SSL trust-store.
  • Type: java.io.File
  • Since: 1.0-beta-3
  • Required: No
  • Expression: ${trustStore}

trustStorePassword:

The password for the SSL trust-store.
  • Type: java.lang.String
  • Since: 1.0-beta-3
  • Required: No
  • Expression: ${trustStorePassword}

userExtensions:

Location of the user-extensions.js to load into the server. If defaultUserExtensionsEnabled is true, then this file will be appended to the defaults.
  • Type: java.lang.String
  • Since: 1.0-beta-1
  • Required: No
  • Expression: ${userExtensions}

verifyBrowser:

Attempt to verify the named browser configuration. Must be one of the standard valid browser names (and must start with a *), e.g. *firefox, *iexplore, *custom.
  • Type: java.lang.String
  • Since: 1.0-beta-1
  • Required: No
  • Expression: ${verifyBrowser}

workingDirectory:

Working directory where Selenium server will be started from.
  • Type: java.io.File
  • Since: 1.0-beta-1
  • Required: Yes
  • Expression: ${project.build.directory}/selenium