Get all the Timeouts simultaneously.

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

Set the "implicit" value of the Timeouts.

Set the "pageLoad" value of the Timeouts.

Set the "script" value of the Timeouts. Selenium 3 and 4 accept null for this value, which unsets it. The spec doesn't mention this.

Set all the Timeouts simultaneously.

Navigate backward in the browser history.

Navigate forward in the browser history.

Gets the URL of the current page.

Get the title of the current page.

Opens a new page by the given URL.

Refresh the current page

Closes the given window

Switch focus to the frame specified by the FrameSelector.

Switch focus to the frame specified by the FrameSelector.

Switch to a given window

Fullscreens the current window

Returns a handle to the currently focused window

Get the dimensions of the current window.

Maximizes the current window

Minimizes the current window

Set the dimensions of the current window.

Returns a list of all windows available to the session

Specifies the frame used by focusFrame

An opaque identifier for a browser window

Return the element that currently has focus.

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

Search for an element using the given element as root.

Find all elements on the page matching the given selector.

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

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

An opaque identifier for a web page element

Retrieve the value of an element's attribute

Retrieve the value of an element's computed CSS property

Retrieve an element's current position.

Get all visible text within this element.

Determine if the element is enabled.

Determine if the element is selected.

Retrieve the value of an element's property

Return the tag name of the given element.

Clear a textarea or text input element's value.

Click on an 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.Keys

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)

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 (ByCSS "#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 (ByCSS "#foo")
		ignoreReturn $ executeJS [] "someAction()"
		return e

Get the current page source

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

Convenience function to ignore result of a webdriver command.

Retrieve a specific cookie by name.

Retrieve all cookies.

Delete a cookie by name.

Delete all visible cookies on the current page.

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.

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.

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.

Helper to click the center of an element.

Helper to double click the center of an element.

Moves the mouse to the given position relative to the current pointer position.

Moves the mouse to the center of a given element.

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

Perform a sequence of actions from multiple input sources

Release all currently pressed keys and buttons

Generic action that can be pause, pointer, or key

Action source (input device)

Individual key actions

A mouse button

Individual pointer actions

Origin for pointer actions

Accepts the currently displayed alert dialog.

Dismisses the currently displayed alert dialog.

Get the text of an alert dialog.

Sends keystrokes to Javascript prompt() dialog.

Save a screenshot to a particular location.

Grab a screenshot of the current page as a PNG image.

Grab a screenshot of the current page as a PNG image.

Retrieve logs of a specific type from the browser. The W3C spec doesn't define how to do this natively, so we automatically detect the browser and try to use an appropriate method:

• Chrome/Chromium: Chrome DevTools Protocol (CDP)
• Firefox: legacy log endpoint (/log)
• Selenium: legacy log endpoint (/log)
• Other browsers: returns empty list

Common log types: browser, driver, performance, server.

However, the modern way to do this is via withRecordLogsViaBiDi.

Wrapper around withRecordLogsViaBiDi' which uses the WebSocket URL from the current Session. You must make sure to pass _capabilitiesWebSocketUrl = Just True to enable this. This will not work with Selenium 3.

Connect to WebSocket URL and subscribe to log events using the W3C BiDi protocol; see https://w3c.github.io/webdriver-bidi/.

A record that represents a single log entry.

Indicates a log verbosity level.

Get the current geographical location of the device.

Get the current screen orientation for rotatable display devices.

Set the current geographical location of the device.

Set the current screen orientation for rotatable display devices.

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

Emulate a double click on a touch device.

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

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.

Emulate a long click on a touch device.

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.

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

A screen orientation

Uploads a file from the local filesystem by its file path. Returns the remote filepath of the file.

Uploads a raw ByteString with associated file info. Returns the remote filepath of the file.

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

Delete all keys within a given web storage area.

Delete a key in the given web storage area.

Get a list of all keys from a 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.

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

An HTML 5 storage type

Determines if two element identifiers refer to different elements.

Determines if two element identifiers refer to the same element.

Determine if the element is displayed. This function isn't guaranteed to be implemented by the WebDriver spec, but it is found in Selenium. See https://www.w3.org/TR/webdriver1/#element-displayedness.

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