Load the URL of the browser.

Get the url of current opened website.

Search for an element on the page, starting from the document root. The located element will be returned as a Element.

Search for multiple elements on the page, starting from the document root. The located elements will be returned as a List Element. Elements should be returned in the order located in the DOM.

The Element Click command scrolls into view the element if it is not already pointer-interactable, and clicks its in-view center point.

If the element’s center point is obscured by another element, an element click intercepted error is returned. If the element is outside the viewport, an element not interactable error is returned.

Other input way (touch events, mouse up/down ...) can be done by actions

Clear a TEXTAREA or text INPUT element’s value.

Send a sequence of key strokes to an element. You can also use unicode characters like Left arrow or Backspace (keys) WebdriverIO will take care of translating them into unicode characters. You’ll find all supported characters here. To do that, the value has to correspond to a key from the table.

Search for an element on the page, starting from an element. The located element will be returned as a Element.

Search for multiple elements on the page, starting from an element. The located elements will be returned as a List Element. Elements should be returned in the order located in the DOM.

The Is Element Selected command determines if the referenced element is selected or not. This operation only makes sense on input elements of the Checkbox- and Radio Button states, or on option elements.

Determine if an element is currently enabled.

Get tag name of a DOM-element.

Get the text content from a DOM-elemen. Make sure the element you want to request the text from is interactable otherwise you will get an empty string as return value. If the element is disabled or not visible and you still want to receive the text content use getHTML (TODO) as a workaround.

Get an attribute from a DOM-element based attribute name. Returns a attribute value.

Get the value of an element’s property.

Get a css property from a DOM-element. The return value is not formatted.

Note that shorthand CSS properties (e.g. background, font, border, margin, padding, list-style, outline, pause, cue) are not returned, in accordance with the DOM CSS2 specification - you should directly access the longhand properties (e.g. background-color) to access the desired values.

The Get Element Rect command returns the dimensions and coordinates of the given web element. The returned value is a record with x, y, width and height properties.

Note: this command was recently added to the official Webdriver protocol and might not be working with current Selenium driver.

The Take Element Screenshot command takes a screenshot of the visible region encompassed by the bounding rectangle of an element. If given a parameter argument scroll that evaluates to false, the element will not be scrolled into view.

Get source code of the page. This command won’t work in mobile environments for native apps. If you are running hybrid tests make sure that you are in the webview before calling this command.

Navigate backwards in the browser history, if possible.

Navigate forwards in the browser history, if possible.

Refresh the current page.

Get the title of current opened website.

Get handle with tabs in the browser.

Retrieve the list of all window handles available to the session.

Switching window will select the current top-level browsing context used as the target for all subsequent commands. In a tabbed browser, this will typically make the tab containing the browsing context the selected tab.

The Get Window Rect command returns the size and position on the screen of the operating system window corresponding to the current top-level browsing context.

The Set Window Rect command alters the size and the position of the operating system window corresponding to the current top-level browsing context.

The Fullscreen Window command invokes the window manager-specific “full screen” operation, if any, on the window containing the current top-level browsing context. This typically increases the window to the size of the physical display and can hide browser UI elements such as toolbars.

Note: this command was recently added to the official Webdriver protocol and might not be working with current Selenium driver.

The Maximize Window command invokes the window manager-specific “maximize” operation, if any, on the window containing the current top-level browsing context. This typically increases the window to the maximum available size without going full-screen.

The Minimize Window command invokes the window manager-specific “minimize” operation, if any, on the window containing the current top-level browsing context. This typically hides the window in the system tray.

Close current window (and focus on an other window).

Take a screenshot of the current viewport.

Accepts the currently displayed alert dialog. Usually, this is equivalent to clicking on the ‘OK’ button in the dialog.

Dismisses the currently displayed alert dialog. For confirm() and prompt() dialogs, this is equivalent to clicking the ‘Cancel’ button. For alert() dialogs, this is equivalent to clicking the ‘OK’ button.

Gets the text of the currently displayed JavaScript alert(), confirm(), or prompt() dialog.

Keystrokes to send to the prompt() dialog.

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 to the client.

The script argument defines the script to execute 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 args List Json.Value and the values may be accessed via the arguments object in the order specified.

Arguments may be any JSON-primitive, array, or JSON object.

execute
    settings
    "alert(arguments[arguments.length - 1])"
    [ Json.string "4123412", Json.int 3 ]

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 asynchronous and must signal that is done by invoking the provided callback, which is always provided as the final argument to the function. The value to this callback will be returned to the client.

Asynchronous script commands may not span page loads. If an unload event is fired while waiting for a script result, an error should be returned to the client.

The script argument defines the script to execute in the form of a function body. The function will be invoked with the provided args List Json.Value and the values may be accessed via the arguments object in the order specified. The final argument will always be a callback function that must be invoked to signal that the script has finished.

Arguments may be any JSON-primitive, array, or JSON object.

let
    script =
        """
    const {a,b,c,d,done} = arguments;
    setTimeout(function() {
            done(a + b + c + d);
        }, 3000);"""
in
executeAsync
    settings
    script
    [ Json.string "4123412", Json.int 3 ]

Change focus to the parent context. If the current context is the top level browsing context, the context remains unchanged.

TODO improve arguments

Change focus to another frame on the page. If the frame id is null, the server should switch to the page’s default content.

• script - session script timeout - Determines when to interrupt a script that is being evaluated.
• pageLoad - session page load timeout - Provides the timeout limit used to interrupt navigation of the browsing context.
• implicit- session implicit wait timeout - Gives the timeout of when to abort locating an element.

Configure the amount of time that a particular type of operation can execute for before they are aborted and a Timeout error is returned to the client.

Get All Cookies

Get Named Cookie

Delete cookies visible to the current page.

Delete cookie visible to the current page. By providing a cookie name.

Sets a cookie for current page. Make sure you are on the page that should receive the cookie. You can’t set a cookie for an arbitrary page without being on that page.

Actions are a very complex portion of the spec. Some preliminary understanding of concepts is useful:

• tick: a slice of an action chain. Actions from different input sources can be executed simultaneously. These are first lined up from the first action. Every vertical “slice” across the different input sources’ action lists is a tick. A tick is not associated with any particular time value, and lasts as long as the longest action duration inside the tick.
• input source: a representation of an input device like a keyboard, mouse, finger, or pen. There can be any number of input sources. Each one has its own id.
• action: a behavior performed by an input source. Different types of input source have different types of possible actions

The command takes a list of input source actions. In other words, a list of objects, each of which represents an input source and its associated actions. Each input source must have the following properties:

• type: String, one of pointer, key, or none
• id: String, a unique id chosen to represent this input source for this and future actions
• parameters: pointer-type input sources can also have a parameters property, which is an object with a pointerType key specifying either mouse, pen, or touch. If parameters is omitted, the pointerType is considered to be mouse.
• actions: a list of action objects for this particular input source. An action object has different fields based on the kind of input device it belongs to (see also here)

The Release Actions command is used to release all the keys and pointer buttons that are currently depressed. This causes events to be fired as if the state was released by an explicit series of actions. It also clears all the internal state of the virtual devices.

Query the server’s current status. The server should respond with a general “HTTP 200 OK” response if it is alive and accepting commands. The response body should be a JSON object describing the state of the server. All server implementations should return two basic objects describing the server’s current platform and when the server was built. All fields are optional; if omitted, the client should assume the value is unknown. Furthermore, server implementations may include additional fields not listed here.

Functions that is passed to tests, with already created session

Configuration containing url to WebDriver host, used in

• sessionStart
• status

Url to WebDriver host and current browsing session used in most of step functins

Creates a new session with the desired capabilities. and task result in info of created session as Json.Value

Note: Most of cases you don't need it runner will create session for you and stop, after test is done

Stops session created with sessionStart functon

Note: Most of cases you don't need it runner will crates session for you and stop, after test is done