webdriver-0.8.5: a Haskell client for the Selenium WebDriver protocol

Safe HaskellNone




class GetCapabilities t where Source #

A typeclass for readable Capabilities

Minimal complete definition



getCaps :: t -> Capabilities Source #

class SetCapabilities t where Source #

A typeclass for writable Capabilities

Minimal complete definition



setCaps :: Capabilities -> t -> t Source #

modifyCaps :: HasCapabilities t => (Capabilities -> Capabilities) -> t -> t Source #

Modifies the wdCapabilities field of a WDConfig by applying the given function. Overloaded to work with any HasCapabilities instance.

useBrowser :: HasCapabilities t => Browser -> t -> t Source #

A helper function for setting the browser capability of a HasCapabilities instance

useVersion :: HasCapabilities t => String -> t -> t Source #

A helper function for setting the version capability of a HasCapabilities instance

usePlatform :: HasCapabilities t => Platform -> t -> t Source #

A helper function for setting the platform capability of a HasCapabilities instance

useProxy :: HasCapabilities t => ProxyType -> t -> t Source #

A helper function for setting the useProxy capability of a HasCapabilities instance

data Capabilities Source #

A structure describing the capabilities of a session. This record serves dual roles.

  • It's used to specify the desired capabilities for a session before it's created. In this usage, fields that are set to Nothing indicate that we have no preference for that capability.
  • When received from the server , it's used to describe the actual capabilities given to us by the WebDriver server. Here a value of Nothing indicates that the server doesn't support the capability. Thus, for Maybe Bool fields, both Nothing and Just False indicate a lack of support for the desired capability.




defaultCaps :: Capabilities Source #

Default capabilities. This is the same as the Default instance, but with less polymorphism. By default, we use firefox of an unspecified version with default system-wide proxy settings on whatever platform is available . All Maybe capabilities are set to Nothing (no preference).

allCaps :: Capabilities Source #

Same as defaultCaps, but with all Maybe Bool capabilities set to Just True.

data Browser Source #

This constructor simultaneously specifies which browser the session will use, while also providing browser-specific configuration. Default configuration is provided for each browser by firefox, chrome, opera, ie, etc.

This library uses firefox as its Default browser configuration, when no browser choice is specified.








  • ieIgnoreProtectedModeSettings :: Bool

    Whether to skip the protected mode check. If set, tests may become flaky, unresponsive, or browsers may hang. If not set, and protected mode settings are not the same for all zones, an exception will be thrown on driver construction.

  • ieIgnoreZoomSetting :: Bool

    Indicates whether to skip the check that the browser's zoom level is set to 100%. Value is set to false by default.

  • ieInitialBrowserUrl :: Maybe Text

    Allows the user to specify the initial URL loaded when IE starts. Intended to be used with ignoreProtectedModeSettings to allow the user to initialize IE in the proper Protected Mode zone. Using this capability may cause browser instability or flaky and unresponsive code. Only "best effort" support is provided when using this capability.

  • ieElementScrollBehavior :: IEElementScrollBehavior

    Allows the user to specify whether elements are scrolled into the viewport for interaction to align with the top or bottom of the viewport. The default value is to align with the top of the viewport.

  • ieEnablePersistentHover :: Bool

    Determines whether persistent hovering is enabled (true by default). Persistent hovering is achieved by continuously firing mouse over events at the last location the mouse cursor has been moved to.

  • ieEnableElementCacheCleanup :: Bool

    Determines whether the driver should attempt to remove obsolete elements from the element cache on page navigation (true by default). This is to help manage the IE driver's memory footprint , removing references to invalid elements.

  • ieRequireWindowFocus :: Bool

    Determines whether to require that the IE window have focus before performing any user interaction operations (mouse or keyboard events). This capability is false by default, but delivers much more accurate native events interactions.

  • ieBrowserAttachTimeout :: Integer

    The timeout, in milliseconds, that the driver will attempt to locate and attach to a newly opened instance of Internet Explorer . The default is zero, which indicates waiting indefinitely.

  • ieLogFile :: Maybe FilePath

    The path to file where server should write log messages to. By default it writes to stdout.

  • ieLogLevel :: IELogLevel

    The log level used by the server. Defaults to IELogFatal

  • ieHost :: Maybe Text

    The address of the host adapter on which the server will listen for commands.

  • ieExtractPath :: Maybe Text

    The path to the directory used to extract supporting files used by the server. Defaults to the TEMP directory if not specified.

  • ieSilent :: Bool

    Suppresses diagnostic output when the server is started.

  • ieForceCreateProcess :: Bool

    Forces launching Internet Explorer using the CreateProcess API. If this option is not specified, IE is launched using the IELaunchURL, if it is available. For IE 8 and above, this option requires the TabProcGrowth registry value to be set to 0.

  • ieSwitches :: Maybe Text

    Specifies command-line switches with which to launch Internet Explorer. This is only valid when used with the forceCreateProcess.



  • operaBinary :: Maybe FilePath

    Server-side path to the Opera binary

  • operaProduct :: Maybe String

    Which Opera product we're using, e.g. "desktop", "core"

  • operaDetach :: Bool

    Whether the Opera instance should stay open after we close the session. If false, closing the session closes the browser.

  • operaAutoStart :: Bool

    Whether to auto-start the Opera binary. If false, OperaDriver will wait for a connection from the browser. By default this is True.

  • operaIdle :: Bool

    Whether to use Opera's alternative implicit wait implementation. It will use an in-browser heuristic to guess when a page has finished loading. This feature is experimental, and disabled by default.

  • operaDisplay :: Maybe Int

    (*nix only) which X display to use.

  • operaLauncher :: Maybe FilePath

    Path to the launcher binary to use. The launcher is a gateway between OperaDriver and the Opera browser. If Nothing, OperaDriver will use the launcher supplied with the package.

  • operaPort :: Maybe Word16

    The port we should use to connect to Opera. If Just 0 , use a random port. If Nothing, use the default Opera port. The default opera constructor uses Just 0, since Nothing is likely to cause "address already in use" errors.

  • operaHost :: Maybe String

    The host Opera should connect to. Unless you're starting Opera manually you won't need this.

  • operaOptions :: Maybe String

    Command-line arguments to pass to Opera.

  • operaLogFile :: Maybe FilePath

    Where to send the log output. If Nothing, logging is disabled.

  • operaLogPref :: LogLevel

    Log level preference. Defaults to LogInfo

Browser Text

some other browser, specified by a string name

firefox :: Browser Source #

Default Firefox settings. All Maybe fields are set to Nothing. ffLogPref is set to LogInfo.

chrome :: Browser Source #

Default Chrome settings. All Maybe fields are set to Nothing, no options are specified, and no extensions are used.

ie :: Browser Source #

Default IE settings. See the IE constructor for more details on individual defaults

opera :: Browser Source #

Default Opera settings. See the Opera constructor for more details on individual defaults.

data ProxyType Source #

Available settings for the proxy Capabilities field



Use a proxy auto-config file specified by URL


Manually specify proxy hosts as hostname:port strings. Note that behavior is undefined for empty strings.

data UnexpectedAlertBehavior Source #


Bounded UnexpectedAlertBehavior Source # 
Enum UnexpectedAlertBehavior Source # 
Eq UnexpectedAlertBehavior Source # 
Ord UnexpectedAlertBehavior Source # 
Read UnexpectedAlertBehavior Source # 
Show UnexpectedAlertBehavior Source # 
ToJSON UnexpectedAlertBehavior Source # 
FromJSON UnexpectedAlertBehavior Source # 

data LogLevel Source #

Indicates a log verbosity level. Used in Firefox and Opera configuration.

data IELogLevel Source #

Logging levels for Internet Explorer


Bounded IELogLevel Source # 
Enum IELogLevel Source # 
Eq IELogLevel Source # 
Ord IELogLevel Source # 
Read IELogLevel Source # 
Show IELogLevel Source # 
ToJSON IELogLevel Source # 
FromJSON IELogLevel Source # 
Default IELogLevel Source # 


def :: IELogLevel #

data IEElementScrollBehavior Source #

Specifies how elements scroll into the viewport. (see ieElementScrollBehavior)




Bounded IEElementScrollBehavior Source # 
Enum IEElementScrollBehavior Source # 
Eq IEElementScrollBehavior Source # 
Ord IEElementScrollBehavior Source # 
Read IEElementScrollBehavior Source # 
Show IEElementScrollBehavior Source # 
ToJSON IEElementScrollBehavior Source # 
FromJSON IEElementScrollBehavior Source # 
Default IEElementScrollBehavior Source #