Create a new session with the given Capabilities. The returned session becomes the "current session" for this action.

Note: if you're using runSession to run your WebDriver commands, you don't need to call this explicitly.

Close the current session and the browser associated with it.

Retrieve a list of active sessions and their Capabilities.

Get the actual server-side Capabilities of the current session.

Opens a new page by the given URL.

Navigate forward in the browser history.

Navigate backward in the browser history.

Refresh the current page

Gets the URL of the current page.

Get the current page source

Get the title of the current page.

Save a screenshot to a particular location

Grab a screenshot of the current page as a PNG image

Grab a screenshot as a base-64 encoded PNG image. This is the protocol-defined format.

Sets the amount of time (ms) we implicitly wait when searching for elements.

Sets the amount of time (ms) we wait for an asynchronous script to return a result.

Sets the amount of time (ms) to wait for a page to finish loading before throwing a Timeout exception.

An opaque identifier for a web page element.

Specifies element(s) within a DOM tree using various selection methods.

Find an element on the page using the given element selector.

Find all elements on the page matching the given selector.

Search for an element using the given element as root.

Find all elements matching a selector, using the given element as root.

Click on an element.

Submit a form element. This may be applied to descendents of a form element as well.

Get all visible text within this element.

Send a sequence of keystrokes to an element. All modifier keys are released at the end of the function. Named constants for special modifier keys can be found in Test.WebDriver.Common.Keys

Similar to sendKeys, but doesn't implicitly release modifier keys afterwards. This allows you to combine modifiers with mouse clicks.

Clear a textarea or text input element's value.

Retrieve the value of an element's attribute

Retrieve the value of an element's computed CSS property

Retrieve an element's current position.

Retrieve an element's current size.

Determine if the element is selected.

Determine if the element is enabled.

Determine if the element is displayed.

Return the tag name of the given element.

Return the element that currently has focus.

Describe the element. Returns a JSON object whose meaning is currently undefined by the WebDriver protocol.

Determines if two element identifiers refer to the same element.

Determines if two element identifiers refer to different elements.

Inject a snippet of Javascript into the page for execution in the context of the currently selected frame. The executed script is assumed to be synchronous and the result of evaluating the script is returned and converted to an instance of FromJSON.

The first parameter defines a sequence of arguments to pass to the javascript function. Arguments of type Element will be converted to the corresponding DOM element. Likewise, any elements in the script result will be returned to the client as Elements.

The second parameter defines the script itself in the form of a function body. The value returned by that function will be returned to the client. The function will be invoked with the provided argument list and the values may be accessed via the arguments object in the order specified.

When using executeJS, GHC might complain about an ambiguous type in situations where the result of the executeJS call is ignored/discard. Consider the following example:

	jsExample = do
		e <- findElem (ById "foo")
		executeJS [] "someAction()"
		return e

Because the result of the executeJS is discarded, GHC cannot resolve which instance of the fromJSON class to use when parsing the Selenium server response. In such cases, we can use the ignoreReturn helper function located in Test.WebDriver.JSON. ignoreReturn has no runtime effect; it simply helps the type system by expicitly providing a fromJSON instance to use.

	import Test.WebDriver.JSON (ignoreReturn)
	jsExample = do
		e <- findElem (ById "foo")
		ignoreReturn $ executeJS [] "someAction()"
		return e

Executes a snippet of Javascript code asynchronously. This function works similarly to executeJS, except that the Javascript is passed a callback function as its final argument. The script should call this function to signal that it has finished executing, passing to it a value that will be returned as the result of asyncJS. A result of Nothing indicates that the Javascript function timed out (see setScriptTimeout)

An existential wrapper for any ToJSON instance. This allows us to pass parameters of many different types to Javascript code.

An opaque identifier for a browser window

A special WindowHandle that always refers to the currently focused window. This is also used by the Default instance.

Returns a handle to the currently focused window

Closes the given window

Returns a list of all windows available to the session

Maximizes the current window if not already maximized

Get the dimensions of the current window.

Set the dimensions of the current window.

Get the coordinates of the current window.

Set the coordinates of the current window.

Switch focus to the frame specified by the FrameSelector.

Specifies the frame used by focusFrame

Cookies are delicious delicacies. When sending cookies to the server, a value of Nothing indicates that the server should use a default value. When receiving cookies from the server, a value of Nothing indicates that the server is unable to specify the value.

Creates a Cookie with only a name and value specified. All other fields are set to Nothing, which tells the server to use default values.

Retrieve all cookies visible to the current page.

Set a cookie. If the cookie path is not specified, it will default to "/". Likewise, if the domain is omitted, it will default to the current page's domain

Delete a cookie. This will do nothing is the cookie isn't visible to the current page.

Delete all visible cookies on the current page.

Get the text of an alert dialog.

Sends keystrokes to Javascript prompt() dialog.

Accepts the currently displayed alert dialog.

Dismisses the currently displayed alert dialog.

Moves the mouse to the given position relative to the active element.

Moves the mouse to the center of a given element.

Moves the mouse to the given position relative to the given element.

Click at the current mouse position with the given mouse button.

A mouse button

Press and hold the left mouse button down. Note that undefined behavior occurs if the next mouse command is not mouseUp.

Release the left mouse button.

Perform the given action with the left mouse button held down. The mouse is automatically released afterwards.

Double click at the current mouse location.

An HTML 5 storage type

Get the current number of keys in a web storage area.

Get a list of all keys from a web storage area.

Delete all keys within a given web storage area.

Get the value associated with a key in the given web storage area. Unset keys result in empty strings, since the Web Storage spec makes no distinction between the empty string and an undefined value.

Set a key in the given web storage area.

Delete a key in the given web storage area.

A screen orientation

Get the current screen orientation for rotatable display devices.

Set the current screen orientation for rotatable display devices.

Get the current geographical location of the device.

Set the current geographical location of the device.

Single tap on the touch screen at the given element's location.

Emulates pressing a finger down on the screen at the given location.

Emulates removing a finger from the screen at the given location.

Emulates moving a finger on the screen to the given location.

Emulate finger-based touch scroll. Use this function if you don't care where the scroll begins

Emulate finger-based touch scroll, starting from the given location relative to the given element.

Emulate a double click on a touch device.

Emulate a long click on a touch device.

Emulate a flick on the touch screen. The coordinates indicate x and y velocity, respectively. Use this function if you don't care where the flick starts.

Emulate a flick on the touch screen.

Uploads a file from the local filesystem by its file path.

Uploads a raw bytestring with associated file info.

Lowest level interface to the file uploading mechanism. This allows you to specify the exact details of the zip entry sent across network.

Get information from the server as a JSON Value. For more information about this object see https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#status

Retrieve the log buffer for a given log type. The server-side log buffer is reset after each request.

Which log types are available is server defined, but the wire protocol lists these as common log types: client, driver, browser, server

Get a list of available log types.

A record that represents a single log entry.

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