webdriver.core — webdriver 0.9.0

alert-accept clj

(alert-accept driver)

accepts alert

alert-dismiss clj

(alert-dismiss driver)

dismisses an alert

alert-text clj

(alert-text driver)

returns the text contained in a js alert box

attr clj

(attr webelement attribute)

(attr driver lookup-type lookup-string attribute)

returns the value of an element's attribute

by clj

(by lookup-type lookup-string)

Returns a By object. Used for element queries

clear clj

(clear driver webelement)

(clear driver lookup-type lookup-string)

clears webelement

click clj

(click webelement)

(click driver webelement)

(click driver lookup-type & lookup-strings)

clicks an element

cookie clj

(cookie driver cookie-name)

(cookie driver cookie-name cookie-value)

Creates or retrieves a cookie named cookie-name. Sets cookie's value to cookie-value if provided

create-driver clj

(create-driver driver-type)

(create-driver driver-type args)

creates a chrome or firefox driver based on passing in :chrome or :firefox. args would be a verctor for command line arguments like ["--headless"]

css clj

(css webelement attribute)

(css driver lookup-type lookup-string attribute)

returns the value of a webelement's css value attribute

delete-elm clj

(delete-elm driver elm)

(delete-elm driver lookup-type lookup-string)

driver-quit clj

(driver-quit driver)

calls quit on driver

enabled? clj

(enabled? elm)

(enabled? driver lookup-type lookup-string)

execute-script clj

(execute-script webdriver js & js-args)

Executes js in webdriver

focused-element clj

(focused-element driver)

get-element clj

(get-element driver lookup-type lookup-string)

returns the first element matching lookup-type and lookup-string

get-element-value clj

(get-element-value webelement attribute)

(get-element-value driver lookup-type lookup-string attribute)

gets the value of an element. :text for text and :value for value

get-elements clj

(get-elements driver lookup-type lookup-string)

finds elements that match lookup-type and lookup-string and returns a vector of those WebElements

get-visible-element clj

(get-visible-element driver lookup-type lookup-string)

returns the first visible elmeent matching lookip-type and lookup-string

html clj

(html options & content)

A wrapper around hiccup's html macro to avoid requiring yet another require

iframe clj

(iframe driver n)

(iframe driver lookup-type lookup-string)

switches to iframe by index or webelement (via calling (get-element lookup-type lookup-string))

iframe-default clj

(iframe-default driver)

switches to default content (main body of the html that contains all the iframes)

iframe-parent clj

(iframe-parent driver)

switches to parent iframe

implicit-wait clj

(implicit-wait driver timeout)

sets driver's implicit wait timeout (in seconds)

input-text clj

(input-text driver webelement s clear-element)

sets the value of a text input. If clear-element, element will be cleared before setting the text input

insert-html clj

(insert-html driver elm html)

Appends given html to elm.. elm is the parent and html will be the child

is-visible clj

(is-visible element)

(is-visible driver lookup-type lookup-string)

Returns true if element is visible and enabled

options clj

(options elm)

(options driver lookup-type lookup-string)

returns a vector of the options available to elm. returns nil if elm is not a select element.

parent clj

(parent e)

(parent driver lookup-type lookup-string)

returns the parent of e

post-sib clj

(post-sib e)

(post-sib driver lookup-type lookup-string)

returns a coll containing the following sibling elements of e

pre-sib clj

(pre-sib e)

(pre-sib driver lookup-type lookup-string)

returns a coll containing the preceding sibling elements of e

q clj

(q driver s)

Finds and returns webelement with name, id, tagName, className, linkText, text, or xpath. Note: not great to use if using implicit waits.

screen-shot clj

(screen-shot driver output)

scroll-into-view clj

(scroll-into-view driver webelement)

(scroll-into-view driver lookup-type lookup-string)

scrolls webelemnt into view

select-elm clj

(select-elm e)

(select-elm driver lookup-type lookup-string)

select-elm-val clj

(select-elm-val e)

(select-elm-val driver lookup-type lookup-string)

send-keys clj

(send-keys element s)

sends element the keys found in str s

set-element clj

(set-element driver e s)

(set-element driver lookup-type lookup-string s)

sets element e to value s. For select or input elements

set-elements clj

(set-elements driver e v)

(set-elements driver lookup-type lookup-strings values)

sets coll of elements e to coll of values v

set-elms clj

(set-elms driver coll)

(set-elms driver lookup-type coll)

partitions coll into lists of 2 each list becomes a key value pair where key is an element identifier and value is the value that element will be set to Eg: (set-elms driver :id [:input1 "hello" :input2 "world"]) if you pass in only a driver and coll, every odd element should be an WebElement

set-file-input clj

(set-file-input element s)

Sets file input's path

siblings clj

(siblings e)

(siblings driver lookup-type lookup-string)

returns a map containing colls with the :preceding and :following sibling elements of e

switch-to-alert clj

(switch-to-alert driver)

to clj

(to driver url)

Navigates driver to the given url

to-localhost clj

(to-localhost driver)

Navigate driver to localhost, ignoring thrown exceptions

transitionend-js clj

try-click clj

(try-click driver lookup-type lookup-string)

(try-click driver lookup-type lookup-string timeout)

repeatedly trys to click webelement until no exception occurs or the timeout (seconds) expires

unfocus clj

(unfocus driver)

unfocuses all elements

visible? clj

(visible? elm)

(visible? driver lookup-type lookup-string)

Returns true if element is visible

wait-click clj

(wait-click driver lookup-type lookup-string)

(wait-click driver lookup-type lookup-string timeout)

waits with timeout (seconds) for element then clicks

wait-elm-dom clj

(wait-elm-dom driver lookup-type lookup-string)

(wait-elm-dom driver lookup-type lookup-string max-wait)

Waits for element to exist in dom with a timeout of max-wait (seconds)

wait-for-element clj

(wait-for-element driver lookup-type lookup-string)

(wait-for-element driver lookup-type lookup-string max-wait)

(wait-for-element driver lookup-type lookup-string max-wait poll-interval)

Explicitly waits for element to be clickable with a timeout of max-wait (seconds) and a poll-interval (milliseconds)

wait-for-trans clj

(wait-for-trans driver elm f)

(wait-for-trans driver elm timeout f)

(wait-for-trans driver elm timeout expected-transitions f)

waits for transitions of elm triggered by f to finish. timeout (milliseconds) should be longer than elm's transition duration expected-transitions is an int that should represent the number of transitions elm will go through when trigger f is executed

wait-q clj

(wait-q driver lookup-type lookup-string)

(wait-q driver lookup-type lookup-string timeout)

(wait-q driver lookup-type lookup-string timeout require-visible)

returns a list of elements. Does not return elements until the query contains visible elements require-visible determines if the final seq returned are only visible elements matching the query

with-all-drivers clj macro

(with-all-drivers driver-args & body)

Same as with-driver but evaluates the forms in body agains all supported driver types. See examples in the unit tests

with-driver clj macro

(with-driver driver-type driver-args & body)

creates a driver, executes the forms in body, and closes the driver. driver is closed in the case of an exception

with-webdriver clj macro

(with-webdriver [driver &
                 {:keys [driver-type driver-args]
                  :as params
                  :or {driver-args [] driver-type :chrome}}]
                &
                body)