Attaches a file to an element
element will be attached. It can be located by CSS|XPath|ILocator.
path of attached file. This path is relative to the current project directory (where package.json is located)
Checks that the title of a window/page is equal to the provided one. The verify point is considered: Passed if the values match; otherwise the test result is: Failed.
The title attribute of the current document.
Clears an HTML <textarea> or text <input> element's value.
located by CSS|XPath|ILocator.
Clicks on a link or a button, identified by a locator.
located by CSS|XPath|ILocator.
(optional) element to search in CSS|XPath|ILocator.
Clicks on the active JavaScript native popup window, created by window.alert|window.confirm|window.prompt.
Click options:
Closes the current tab
Closes all tabs except for the current one.
Clears all cookies. If a cookie is specified, it only deletes that cookie.
(optional) cookie name.
Performs a double-click on an element matched by CSS|XPath|ILocator. The context can be specified as second parameter to narrow the search.
located by CSS|XPath|ILocator.
(optional) element to search in CSS|XPath|ILocator.
Does one of the following actions:
located by CSS|XPath|ILocator, or a coordinate (x,y)
located by CSS|XPath|ILocator, or a coordinate (x,y)
drag and drop time in milliseconds.
Executes a sync script on a page. Pass arguments to the function as additional parameters.
Returns the results. To receive the results you should use an async
function
and await
.
: list of arguments to pass to function.
Returns a list of window handles for every open top-level browsing context. Useful for referencing a specific handle when calling gondola.switchToWindow(handle)
Gets the current driver's browser object
Gets the current URL from the browser
Returns the window handle for the current top-level browsing context. It can be used as an argument for switchToWindow().
Gets a list attributes of an element matched by CSS|XPath|ILocator. The context can be specified as second parameter to narrow the search.
located by CSS|XPath|ILocator.
name of array attributes
(optional) element to search in CSS|XPath|ILocator.
Retrieves an attribute from each of the located elements.
located by CSS|XPath|ILocator.
attribute name.
Gets the text from a popup created by window.alert|window.confirm|window.prompt. If no popup is visible, it returns an error.
Retrieves a page title and returns it as string.
Maximizes the current window. This method is for desktop browsers only.
Moves the mouse over the first element that matches the given locator. If the first parameter is null then the page is used. If the second parameter is given, then the mouse is moved to an offset based on the the element’s top-left corner. Otherwise, the mouse is moved to the center of the element.
located by CSS|XPath|ILocator.
offset from the element’s top-left corner or page.
Opens a web page in a browser. Requires a relative or absolute url. If url starts with /, it opens a web page of a site defined by the url config parameter.
url path or global url.
Opens a new tab and switches to it.
Presses a key in the browser (on a focused element). To press a key in combination with modifier keys, pass the sequence as an array
or array of keys to press. Can use enum KeyCode to input key.
Reloads the current page.
Scrolls the element's parent container so the element is visible to the user.
located by CSS|XPath|ILocator.
(optional) Object with the following properties: - "behavior": (optional) Defines the transition animation. Can be "auto" or "smooth". Defaults to "auto". - "block": (optional) Defines vertical alignment. Can be "start", "center", "end", or "nearest". Defaults to "start". - "inline": (optional) Defines horizontal alignment. Can be "start", "center", "end", or "nearest". Defaults to "nearest".
Scrolls to a particular set of coordinates inside a given element.
located by CSS|XPath|ILocator.
(optional, 0 by default) X-axis offset.
(optional, 0 by default) Y-axis offset.
Selects an option inside a dropdown-list with a specific index.
the list control that contains the items, such as 'select' or 'ul' element.
option index (zero-based)
Sets one cookie for the current page. Make sure you are on the page that should receive the cookie.
a cookie object.Uses cookie format https://w3c.github.io/webdriver/#cookies
Sets the text in a javascript prompt popup.
text use to set
Switches focus to a particular tab using its number. It waits for all tabs to load before switching.
"previous" | "next" indicate prev or next tab will be switch
(optional, default 1) offset from current handle index in sequence window handle.
Switches the context to another frame. In the case of a null locator it reverts to the parent frame.
Note: In the case of cross-domain iFrame automation on mobile, "Same-origin Policy" prevents automated test tools from automating iFrames which have a different domain than their parent. To make your web application testable, please make sure that all cross-domain-iframe problems are bypassed.
located by CSS|XPath|strict locator.
Switches to the window with the specified handle.
a string representing a window handle, should be one of the strings that was returned in a call to getAllWindowHandles
Waits a number of seconds for an element to become clickable.
element located by CSS|XPath|ILocator.
(optional, default : 1s) time for waiting(seconds), uses smartwait as the timeout if timeout is not specified.
Waits for an element's property have an expected value. At this time it only supports the "Webdriver" helper
located by CSS|XPath|ILocator.
property name
property's expected value
(optional, default : 1s) time for waiting(seconds), uses smartwait as the timeout if timeout is not specified.
(optional) element to search in for the CSS|XPath|ILocator.
Waits for element to be enabled (by default waits for 1sec). Element can be located by CSS|XPath|ILocator.
to be enabled.
(optional, default : 1s) time for waiting(seconds), uses smartwait as the timeout if a timeout is not specified.
Waits for text appear in an html page. If context is specified, just wait for text appear in the context's container
text to wait for.
(optional) element to narrow search CSS|XPath|ILocator.
(optional) time for waiting (seconds), uses smartwait as the timeout if timeout isn't specified.
Waits for the value attribute to equal the specified value
element whose value attribute we're using
text that we're waiting the the value attribute to be equal to
(optional, default : 1s) time for waiting(second), uses smartwait as the timeout if a timeout is not specified.
Waits for an element's property to change value. At this time it only supports the "Webdriver" helper
located by CSS|XPath|ILocator.
property name
(optional) if current propValue doesn't equal oldValue, it will stop waiting.
(optional, default : 1s) time for waiting(seconds), uses smartwait as the timeout if timeout is not specified.
(optional) element to search in CSS|XPath|ILocator.
Waits for a function to return true.
callback function will be executed
(optional, default : 1s) time to wait in seconds.
(optional, default : 1s) interval between checking the conditional in seconds.
Set of extended actions supported by Gondola