The cl-webdriver-client Reference Manual

4.1.1 cl-webdriver-client/cl-webdriver-client.asd

Source

cl-webdriver-client.asd.

Parent Component

cl-webdriver-client (system).

ASDF Systems

cl-webdriver-client.

---

4.1.2 cl-webdriver-client/src/package.lisp

Source

cl-webdriver-client.asd.

Parent Component

src (module).

Packages

• webdriver-client.
• webdriver-client-user.
• webdriver-client-utils.

---

4.1.3 cl-webdriver-client/src/errors.lisp

Source

cl-webdriver-client.asd.

Parent Component

src (module).

Public Interface

• no-such-element-error (condition).
• print-object (method).

Internals

• find-error (condition).
• protocol-error (condition).
• protocol-error-body (reader method).
• protocol-error-error (function).
• protocol-error-status (reader method).
• stale-element-reference (condition).

---

4.1.4 cl-webdriver-client/src/capabilities.lisp

Source

cl-webdriver-client.asd.

Parent Component

src (module).

Public Interface

• *default-capabilities* (special variable).
• chrome-capabilities (function).
• firefox-capabilities (function).
• make-capabilities (function).
• merge-capabilities (function).

Internals

• capabilities (structure).
• capabilities-always-match (reader).
• (setf capabilities-always-match) (writer).
• capabilities-first-match (reader).
• (setf capabilities-first-match) (writer).
• capabilities-p (function).
• copy-capabilities (function).
• detect-platform-name (function).
• serialize-capabilities (function).

---

4.1.5 cl-webdriver-client/src/session.lisp

Source

cl-webdriver-client.asd.

Parent Component

src (module).

Public Interface

• delete-session (function).
• make-session (function).
• print-object (method).
• start-interactive-session (function).
• stop-interactive-session (function).
• use-session (function).
• with-session (macro).

Internals

• *session* (special variable).
• keyword-plist-p (function).
• plist-p (function).
• session (class).
• session-id (reader method).
• session-path (function).

---

4.1.6 cl-webdriver-client/src/contexts.lisp

Source

cl-webdriver-client.asd.

Parent Component

src (module).

Public Interface

• close-window (function).
• get-window-handle (function).
• get-window-handles (function).
• new-window (function).
• switch-to-frame (function).
• switch-to-window (function).

---

4.1.7 cl-webdriver-client/src/cookie.lisp

Source

cl-webdriver-client.asd.

Parent Component

src (module).

Public Interface

• cookie (function).
• (setf cookie) (function).
• cookie (class).
• delete-all-cookies (function).
• delete-cookie (function).
• encode-json (method).
• find-cookie (function).
• make-cookie (function).

---

4.1.8 cl-webdriver-client/src/keys.lisp

Source

cl-webdriver-client.asd.

Parent Component

src (module).

Public Interface

• key (function).
• keys (function).

Internals

*keymap* (special variable).

---

4.1.9 cl-webdriver-client/src/mouse.lisp

Source

cl-webdriver-client.asd.

Parent Component

src (module).

Public Interface

• mouse-click (function).
• mouse-move-to (function).

---

4.1.10 cl-webdriver-client/src/window.lisp

Source

cl-webdriver-client.asd.

Parent Component

src (module).

Public Interface

window-resize (function).

Internals

• get-window-rect (function).
• set-window-rect (function).

---

4.1.11 cl-webdriver-client/src/user-prompts.lisp

Source

cl-webdriver-client.asd.

Parent Component

src (module).

Public Interface

• accept-alert (function).
• alert-text (function).
• (setf alert-text) (function).
• dismiss-alert (function).

---

4.1.12 cl-webdriver-client/src/actions.lisp

Source

cl-webdriver-client.asd.

Parent Component

src (module).

Public Interface

perform-actions (function).

Internals

• expand-action-item (function).
• expand-actions (function).

---

4.1.13 cl-webdriver-client/src/http.lisp

Source

cl-webdriver-client.asd.

Parent Component

src (module).

Internals

• *prefix* (special variable).
• *uri* (special variable).
• check (function).
• decode (function).
• encode (function).
• http-delete (function).
• http-delete-check (function).
• http-get (function).
• http-get-check (function).
• http-get-value (function).
• http-post (function).
• http-post-check (function).
• http-post-value (function).
• make-uri (function).
• value (function).
• with-decode-and-handler (macro).

---

4.1.14 cl-webdriver-client/src/webdriver.lisp

Source

cl-webdriver-client.asd.

Parent Component

src (module).

Public Interface

• active-element (function).
• back (function).
• element-attribute (function).
• element-clear (function).
• element-click (function).
• element-displayed (function).
• element-enabled (function).
• element-id (reader method).
• element-rect (function).
• element-screenshot (function).
• element-send-keys (function).
• element-tagname (function).
• element-text (function).
• execute-script (function).
• find-element (function).
• find-elements (function).
• log-types (function).
• logs (function).
• page-source (function).
• page-title (function).
• print-object (method).
• refresh (function).
• screenshot (function).
• url (function).
• (setf url) (function).
• webdriver-status (function).

Internals

• by (function).
• element (class).
• element-location-strategy (type).
• handle-find-error (function).

---

4.1.15 cl-webdriver-client/src/utils.lisp

Source

cl-webdriver-client.asd.

Parent Component

src (module).

Public Interface

• *default-element-func* (special variable).
• *timeout* (special variable).
• attr (function).
• classlist (function).
• classname (function).
• click (function).
• elem (function).
• find-elem (function).
• get-cookie (function).
• id (function).
• send-key (function).
• send-keys (function).
• text (function).
• wait-for (function).

---

6.1.1 Special variables

Special Variable: *default-capabilities* ¶

The default capabilities.

Category: Capabilities

Package

webdriver-client.

Source

capabilities.lisp.

Special Variable: *default-element-func* ¶

Function used to get the ’default element’ by selenium-utils functions. It is ACTIVE-ELEMENT function by default.

Package

webdriver-client-utils.

Source

utils.lisp.

Special Variable: *timeout* ¶

Default timeout value to use in selenium-utils functions.

Package

webdriver-client-utils.

Source

utils.lisp.

---

6.1.2 Macros

Macro: with-session (capabilities &body body) ¶

Starts a new session, and evaluates BODY in the context of that session. The session is deleted when finished.

Category: Session
See: MAKE-SESSION

Package

webdriver-client.

Source

session.lisp.

---

6.1.3 Ordinary functions

Function: accept-alert (&key session) ¶

Accept Alert.

Category: User prompts
See: https://www.w3.org/TR/webdriver1/#dfn-accept-alert

Package

webdriver-client.

Source

user-prompts.lisp.

Function: active-element (&key session) ¶

Return the active element of the current browsing context’s document.
The active element is the Element within the DOM that currently has focus. If there’s no active element, an error is signaled.

Category: Elements
See: https://www.w3.org/TR/webdriver2/#get-active-element.
See: https://developer.mozilla.org/en-US/docs/Web/API/Document/activeElement.

Package

webdriver-client.

Source

webdriver.lisp.

Function: alert-text (&key session) ¶

Get Alert Text.

Category: User prompts
See: https://www.w3.org/TR/webdriver1/#get-alert-text

Package

webdriver-client.

Source

user-prompts.lisp.

Function: (setf alert-text) (&key session) ¶

The Send Alert Text command sets the text field of a window.prompt user prompt to the given value.

Category: User prompts
See: https://www.w3.org/TR/webdriver1/#send-alert-text

Package

webdriver-client.

Source

user-prompts.lisp.

Function: attr (name &optional selector) ¶

Get acttive element attribute.

Package

webdriver-client-utils.

Source

utils.lisp.

Function: back (&key session) ¶

This command causes the browser to traverse one step backward in the joint session history of the current top-level browsing context. This is equivalent to pressing the back button in the browser chrome or invoking window.history.back.

Category: Navigation
See: https://www.w3.org/TR/webdriver1/#dfn-back .

Package

webdriver-client.

Source

webdriver.lisp.

Function: chrome-capabilities (&rest options) ¶

Specifies Chrome specific capabilities.

Category: Capabilities https://chromedriver.chromium.org/capabilities#h.p_ID_102

Package

webdriver-client.

Source

capabilities.lisp.

Function: classlist (&optional selector) ¶

Get active element class list.

Package

webdriver-client-utils.

Source

utils.lisp.

Function: classname (&optional selector) ¶

Get active element classname.

Package

webdriver-client-utils.

Source

utils.lisp.

Function: click (&optional selector) ¶

Click on active element.

Package

webdriver-client-utils.

Source

utils.lisp.

Function: close-window (&key session) ¶

Close the current window.

See: https://www.w3.org/TR/webdriver1/#close-window Category: Contexts

Package

webdriver-client.

Source

contexts.lisp.

Function: cookie (&key session) ¶

Retrieve all cookies visible to the current page.

Category: Cookies
See: https://www.w3.org/TR/webdriver1/#get-all-cookies .
See: https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#sessionsessionidcookie .

Package

webdriver-client.

Source

cookie.lisp.

Function: (setf cookie) (&key session) ¶

Create a cookie in the cookie store associated with the active document’s address using cookie name name, cookie value value, and an attribute-value list of the following cookie concepts listed in the table for cookie conversion from data:

If there is an error during this step, return error with error code unable to set cookie.

See: https://www.w3.org/TR/webdriver1/#dfn-adding-a-cookie .

Package

webdriver-client.

Source

cookie.lisp.

Function: delete-all-cookies (&key session) ¶

Deletes all cookies

Category: Cookies
See: https://www.w3.org/TR/webdriver1/#delete-all-cookies

Package

webdriver-client.

Source

cookie.lisp.

Function: delete-cookie (cookie-name &key session) ¶

Delete the cookie with name COOKIE-NAME.

Category: Cookies
See: https://www.w3.org/TR/webdriver1/#delete-cookie

Package

webdriver-client.

Source

cookie.lisp.

Function: delete-session (session) ¶

Delete the WebDriver SESSION.

Category: Session

Package

webdriver-client.

Source

session.lisp.

Function: dismiss-alert (&key session) ¶

The Dismiss Alert command dismisses a simple dialog if present. A request to dismiss an alert user prompt, which may not necessarily have a dismiss button, has the same effect as accepting it.

Category: User prompts
See: https://www.w3.org/TR/webdriver1/#dismiss-alert

Package

webdriver-client.

Source

user-prompts.lisp.

Function: elem (&optional selector) ¶

If SELECTOR is given, wait for an element that matches the selector to appear. Otherwise, call *DEFAULT-ELEMENT-FUNC* (the active element is returned by default).

Package

webdriver-client-utils.

Source

utils.lisp.

Function: element-attribute (element name &key session) ¶

Return the ELEMENT’s attribute named NAME.

Category: Elements

Package

webdriver-client.

Source

webdriver.lisp.

Function: element-clear (element &key session) ¶

Clear the contents of ELEMENT (for example, a form field element).

Category: Element interaction
See: https://www.w3.org/TR/webdriver1/#dfn-element-clear.

Package

webdriver-client.

Source

webdriver.lisp.

Function: element-click (element &key session) ¶

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.

Category: Element interaction
See: https://www.w3.org/TR/webdriver1/#element-click .

Package

webdriver-client.

Source

webdriver.lisp.

Function: element-displayed (element &key session) ¶

Returns T if ELEMENT is visible.

Category: Elements
See: https://www.w3.org/TR/webdriver1/#element-displayedness .

Package

webdriver-client.

Source

webdriver.lisp.

Function: element-enabled (element &key session) ¶

Returns T if ELEMENT is enabled.

Category: Elements
See: https://www.w3.org/TR/webdriver1/#is-element-enabled .

Package

webdriver-client.

Source

webdriver.lisp.

Function: element-rect (element &key session) ¶

The Get Element Rect command returns the dimensions and coordinates of the given web element. The returned value is a dictionary with the following members:

x
X axis position of the top-left corner of the web element relative to the current browsing context’s document element in CSS pixels.
y
Y axis position of the top-left corner of the web element relative to the current browsing context’s document element in CSS pixels.
height
Height of the web element’s bounding rectangle in CSS pixels.
width
Width of the web element’s bounding rectangle in CSS pixels.

Category: Elements

Package

webdriver-client.

Source

webdriver.lisp.

Function: element-screenshot (element &key session) ¶

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.

Category: Screen capture
See: https://www.w3.org/TR/webdriver1/#take-element-screenshot .

Package

webdriver-client.

Source

webdriver.lisp.

Function: element-send-keys (element keys &key session) ¶

The Element Send Keys command scrolls into view the form control element and then sends the provided keys to the element. In case the element is not keyboard-interactable, an element not interactable error is returned.

KEYS should be a string or a list of characters or control character keywords.

For example:

(element-send-keys el (list :control #t))

See KEY and KEYS functions.

Category: Element interaction
See: https://www.w3.org/TR/webdriver1/#element-send-keys .

Package

webdriver-client.

Source

webdriver.lisp.

Function: element-tagname (element &key session) ¶

Return the ELEMENT’s tag name.

Category: Elements

Package

webdriver-client.

Source

webdriver.lisp.

Function: element-text (element &key session) ¶

The Get Element Text command intends to return an element’s text “as rendered”. An element’s rendered text is also used for locating a elements by their link text and partial link text.

Category: Elements
See: https://www.w3.org/TR/webdriver1/#get-element-text .

Package

webdriver-client.

Source

webdriver.lisp.

Function: execute-script (script args &key session) ¶

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 array and the values may be accessed via the arguments object in the order specified.

Arguments may be any JSON-primitive, array, or JSON object. JSON objects that define a WebElement reference will be converted to the corresponding DOM element. Likewise, any WebElements in the script result will be returned to the client as WebElement JSON objects.

Category: Document handling
See: https://www.w3.org/TR/webdriver1/#executing-script .

Package

webdriver-client.

Source

webdriver.lisp.

Function: find-cookie (cookie-name &key session) ¶

Retrieve the cookie with name COOKIE-NAME.

Category: Cookies
See: https://www.w3.org/TR/webdriver1/#get-named-cookie

Package

webdriver-client.

Source

cookie.lisp.

Function: find-elem (selector &key by) ¶

Find element by SELECTOR. Returns NIL if the element is not found.

Package

webdriver-client-utils.

Source

utils.lisp.

Function: find-element (value &key by session) ¶

The Find Element command is used to find an element in the current browsing context that can be used as the web element context for future element-centric commands.

For example, consider this pseudo code which retrieves an element with the #toremove ID and uses this as the argument for a script it injects to remove it from the HTML document:

let body = session.find.css("#toremove");
session.execute("arguments[0].remove()", [body]);

The BY parameter represents the element location strategy.

It can be one of:
- :id : Finds element by id.
- :class-name : Finds element by class name.
- :css-selector : Returns element that matches css selector.
- :link-text : Returns element that matches <a> element text.
- :partial-link-text: Returns element that matches <a> element text partially.
- :tag-name: Returns element that matches tag name.
- :xpath: Returns element that matches the XPath expression.

If result is empty, a HANDLE-FIND-ERROR is signaled.

Category: Elements
See: https://www.w3.org/TR/webdriver1/#dfn-find-element .

Package

webdriver-client.

Source

webdriver.lisp.

Function: find-elements (value &key by session) ¶

Find elements that match VALUE using location strategy in BY.

Category: Elements
See FIND-ELEMENT.
See https://www.w3.org/TR/webdriver1/#find-elements .

Package

webdriver-client.

Source

webdriver.lisp.

Function: firefox-capabilities (&rest options) ¶

Specify capabilities for Firefox browser.

Example usage:

(firefox-capabilities :args #("–headless"))

Category: Capabilities
See: https://developer.mozilla.org/en-US/docs/Web/WebDriver/Capabilities/firefoxOptions

Package

webdriver-client.

Source

capabilities.lisp.

Function: get-cookie (cookie name) ¶

Get value of COOKIE at NAME.

Package

webdriver-client-utils.

Source

utils.lisp.

Function: get-window-handle (&key session) ¶

Returns the window handle associated with the current top-level browsing context. See: https://www.w3.org/TR/webdriver1/#get-window-handle
Category: Contexts

Package

webdriver-client.

Source

contexts.lisp.

Function: get-window-handles (&key session) ¶

Returns the window handles associated with ech top-level browsing context. See: https://www.w3.org/TR/webdriver1/#get-window-handles
Category: Contexts

Package

webdriver-client.

Source

contexts.lisp.

Function: id (&optional selector) ¶

Get active element id.

Package

webdriver-client-utils.

Source

utils.lisp.

Function: key (key) ¶

Returns a string with KEY’s codepoint.

Category: Actions
See: https://www.w3.org/TR/webdriver/#keyboard-actions

Package

webdriver-client.

Source

keys.lisp.

Function: keys (&rest keys) ¶

Returns a string with characters and control keyword charcters in KEYS list.

Example:

(keys :control #t)

Category: Actions
See: https://www.w3.org/TR/webdriver/#keyboard-actions

Package

webdriver-client.

Source

keys.lisp.

Function: log-types (&key session) ¶

Return the types of logs supported by the WebDriver.

- browser: Javascript console logs from the browser.
- client: Logs from the client side implementation of the WebDriver protocol (e.g. the Java bindings).
- driver: Logs from the internals of the driver (e.g. FirefoxDriver internals).
- performance: Logs relating to the performance characteristics of the page under test (e.g. resource load timings). - server: Logs from within the selenium server.

See: https://github.com/SeleniumHQ/selenium/wiki/Logging .

Package

webdriver-client.

Source

webdriver.lisp.

Function: logs (type &key session) ¶

Return the logs of a particular TYPE. See: LOG-TYPES.

Package

webdriver-client.

Source

webdriver.lisp.

Function: make-capabilities (&key always-match first-match) ¶

Package

webdriver-client.

Source

capabilities.lisp.

Function: make-cookie (name value &key path domain secure expiry) ¶

Create a cookie object.

Category: Cookies

Package

webdriver-client.

Source

cookie.lisp.

Function: make-session (&optional capabilities) ¶

Creates a new WebDriver session with the endpoint node. If the creation fails, a session not created error is returned.

CAPABILITIES are the capabilities to negotate for the new session. If it is NIL, then *DEFAULT-CAPABILITIES* are used. If it is a list, then it is use as parameters for MAKE-CAPABILITIES to build a new CAPABILITIES object. Otherwise, it is assumed to be a CAPABILITIES object.

Category: Session
See: https://www.w3.org/TR/webdriver1/#new-session .
See: https://www.w3.org/TR/webdriver1/#capabilities .

Package

webdriver-client.

Source

session.lisp.

Function: merge-capabilities (cap1 cap2) ¶

Merge two capabilities

Category: Capabilities

Package

webdriver-client.

Source

capabilities.lisp.

Function: mouse-click (button &key session) ¶

Click any mouse button (at the coordinates set by the last moveto command). Note that calling this command after calling buttondown and before calling button up (or any out-of-order interactions sequence) will yield undefined behaviour).

See: https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#sessionsessionidclick

Package

webdriver-client.

Source

mouse.lisp.

Function: mouse-move-to (x y &key element session) ¶

Move the mouse by an offset of the specificed element. If no element is specified, the move is relative to the current mouse cursor. If an element is provided but no offset, the mouse will be moved to the center of the element. If the element is not visible, it will be scrolled into view.

See: https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#sessionsessionidmoveto

Package

webdriver-client.

Source

mouse.lisp.

Function: new-window (&key session) ¶

Create a new top-level browsing context.

Category: Contexts
See: https://w3c.github.io/webdriver/#new-window

Package

webdriver-client.

Source

contexts.lisp.

Function: page-source (&key session) ¶

Returns a string serialization of the DOM of the current browsing context active document.

Category: Navigation
See: https://www.w3.org/TR/webdriver1/#get-page-source

Package

webdriver-client.

Source

webdriver.lisp.

Function: page-title (&key session) ¶

This command returns the document title of the current top-level browsing context, equivalent to calling document.title.

Category: Navigation
See: https://www.w3.org/TR/webdriver2/#get-title .

Package

webdriver-client.

Source

webdriver.lisp.

Function: perform-actions (actions &optional session) ¶

The Actions API provides a low-level interface for providing virtualised device input to the web browser.
Conceptually, the Actions commands divide time into a series of ticks. The local end sends a series of actions which correspond to the change in state, if any, of each input device during each tick. For example, pressing a key is represented by an action sequence consisting of a single key input device and two ticks, the first containing a keyDown action, and the second a keyUp action, whereas a pinch-zoom input is represented by an action sequence consisting of three ticks and two pointer input devices of type touch, each performing a sequence of actions pointerDown, followed by pointerMove, and then pointerUp.

Category: Actions
See: https://www.w3.org/TR/webdriver/#actions

Package

webdriver-client.

Source

actions.lisp.

Function: refresh (&key session) ¶

Refresh the current page.

Category: Navigation

Package

webdriver-client.

Source

webdriver.lisp.

Function: screenshot (&key session) ¶

Screenshots are a mechanism for providing additional visual diagnostic information. They work by dumping a snapshot of the initial viewport’s framebuffer as a lossless PNG image. It is returned to the local end as a Base64 encoded string.

Category: Screen capture
See: https://www.w3.org/TR/webdriver2/#screen-capture .

Package

webdriver-client.

Source

webdriver.lisp.

Function: send-key (key &optional selector) ¶

Send a key to active element.

Package

webdriver-client-utils.

Source

utils.lisp.

Function: send-keys (keys &optional selector) ¶

Send keys to active element.

Package

webdriver-client-utils.

Source

utils.lisp.

Function: start-interactive-session (&optional capabilities) ¶

Start an interactive session. Use this to interact with Selenium driver from a REPL.

Category: Session
See: MAKE-SESSION

Package

webdriver-client.

Source

session.lisp.

Function: stop-interactive-session (&optional ignore-errors) ¶

Stop an interactive session.

Sometimes *SESSION* could be out of sync with Webdriver instance. In that case we may want to ignore errors when trying to delete the session. IGNORE-ERRORS argument controls that.

Category: Session

Package

webdriver-client.

Source

session.lisp.

Function: switch-to-frame (id &key session) ¶

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

In the context of a web browser, a frame is a part of a web page or browser window which displays content independent of its container, with the ability to load content independently.

Category: Contexts
See: https://www.w3.org/TR/webdriver1/#switch-to-frame

Package

webdriver-client.

Source

contexts.lisp.

Function: switch-to-window (window-handle &key 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.

WINDOW-HANDLE is the handle of the window obtained via GET-WINDOW-HANDLE.

See: https://www.w3.org/TR/webdriver1/#switch-to-window
Category: Contexts

Package

webdriver-client.

Source

contexts.lisp.

Function: text (&optional selector) ¶

Get active element’s text.

Package

webdriver-client-utils.

Source

utils.lisp.

Function: url (&key session) ¶

Get the current url in session.

Category: Navigation
See: https://www.w3.org/TR/webdriver1/#dfn-get-current-url .

Package

webdriver-client.

Source

webdriver.lisp.

Function: (setf url) (&key session) ¶

The command causes the user agent to navigate the current top-level browsing context to a new location.

Category: Navigation
See: https://www.w3.org/TR/webdriver1/#dfn-navigate-to .

Package

webdriver-client.

Source

webdriver.lisp.

Function: use-session (session) ¶

Make SESSION the current session.

Category: Session

Package

webdriver-client.

Source

session.lisp.

Function: wait-for (selector &key timeout) ¶

Wait for an element that matches SELECTOR to appear on the screen. TIMEOUT indicates how much time to wait (default is *TIMEOUT*).

Package

webdriver-client-utils.

Source

utils.lisp.

Function: webdriver-status () ¶

Get WebDriver status information

Package

webdriver-client.

Source

webdriver.lisp.

Function: window-resize (&key width height session) ¶

Package

webdriver-client.

Source

window.lisp.

---

6.1.4 Generic functions

Generic Reader: element-id (object) ¶

Package

webdriver-client.

Methods

Reader Method: element-id ((element element)) ¶

automatically generated reader method

Source

webdriver.lisp.

Target Slot

id.

---

6.1.5 Standalone methods

Method: encode-json ((cookie cookie) &optional stream) ¶

Package

json.

Source

cookie.lisp.

Method: print-object ((session session) stream) ¶

Source

session.lisp.

Method: print-object ((element element) stream) ¶

Source

webdriver.lisp.

Method: print-object ((error protocol-error) stream) ¶

Source

errors.lisp.

---

6.1.6 Conditions

Condition: no-such-element-error ¶

Error signaled when no such element is found.

Package

webdriver-client.

Source

errors.lisp.

Direct superclasses

find-error.

---

6.1.7 Classes

Class: cookie ¶

A cookie is described in [RFC6265] by a name-value pair holding the cookie’s data, followed by zero or more attribute-value pairs describing its characteristics.

Category: Cookies

Package

webdriver-client.

Source

cookie.lisp.

Direct methods

encode-json.

Direct slots

Slot: name ¶

The name of the cookie

Initargs

:name

Slot: value ¶

The cookie value

Initargs

:value

Slot: path ¶

The cookie path. Defaults to ’/’ if omitted when adding a cookie.

Initargs

:path

Slot: domain ¶

The domain the cookie is visible to. Defaults to the current browsing context’s active document’s URL domain if omitted when adding a cookie.

Initargs

:domain

Slot: secure ¶

Whether the cookie is a secure cookie. Defaults to false if omitted when adding a cookie.

Initargs

:secure

Slot: http-only ¶

Whether the cookie is an HTTP only cookie. Defaults to false if omitted when adding a cookie.

Initargs

:http-only

Slot: expiry ¶

When the cookie expires, specified in seconds since Unix Epoch. Must not be set if omitted when adding a cookie.

Initargs

:expiry

---

6.2.1 Special variables

Special Variable: *keymap* ¶

See https://www.w3.org/TR/webdriver1/#keyboard-actions

Package

webdriver-client.

Source

keys.lisp.

Special Variable: *prefix* ¶

Package

webdriver-client.

Source

http.lisp.

Special Variable: *session* ¶

The current Selenium WebDriver session.

Package

webdriver-client.

Source

session.lisp.

Special Variable: *uri* ¶

Package

webdriver-client.

Source

http.lisp.

---

6.2.2 Macros

Macro: with-decode-and-handler (body) ¶

Package

webdriver-client.

Source

http.lisp.

---

6.2.3 Ordinary functions

Function: by (type) ¶

An element location strategy is an enumerated attribute deciding what technique should be used to search for elements in the current browsing context. See: https://www.w3.org/TR/webdriver1/#dfn-strategy .

Package

webdriver-client.

Source

webdriver.lisp.

Reader: capabilities-always-match (instance) ¶

Writer: (setf capabilities-always-match) (instance) ¶

Package

webdriver-client.

Source

capabilities.lisp.

Target Slot

always-match.

Reader: capabilities-first-match (instance) ¶

Writer: (setf capabilities-first-match) (instance) ¶

Package

webdriver-client.

Source

capabilities.lisp.

Target Slot

first-match.

Function: capabilities-p (object) ¶

Package

webdriver-client.

Source

capabilities.lisp.

Function: check (response) ¶

Validates the status of Selenium Webdriver response.

Package

webdriver-client.

Source

http.lisp.

Function: copy-capabilities (instance) ¶

Package

webdriver-client.

Source

capabilities.lisp.

Function: decode (json) ¶

Package

webdriver-client.

Source

http.lisp.

Function: detect-platform-name () ¶

Package

webdriver-client.

Source

capabilities.lisp.

Function: encode (plist) ¶

Package

webdriver-client.

Source

http.lisp.

Function: expand-action-item (action-item) ¶

Package

webdriver-client.

Source

actions.lisp.

Function: expand-actions (actions) ¶

Package

webdriver-client.

Source

actions.lisp.

Function: get-window-rect (&key session) ¶

Package

webdriver-client.

Source

window.lisp.

Function: handle-find-error (err &key value by) ¶

Signal the correct type of error depending on PROTOCOL-ERROR-STATUS.

See: https://www.w3.org/TR/webdriver1/#handling-errors

Package

webdriver-client.

Source

webdriver.lisp.

Function: http-delete (path) ¶

Package

webdriver-client.

Source

http.lisp.

Function: http-delete-check (path) ¶

Package

webdriver-client.

Source

http.lisp.

Function: http-get (path) ¶

Package

webdriver-client.

Source

http.lisp.

Function: http-get-check (path) ¶

Package

webdriver-client.

Source

http.lisp.

Function: http-get-value (path) ¶

Package

webdriver-client.

Source

http.lisp.

Function: http-post (path &rest params) ¶

Package

webdriver-client.

Source

http.lisp.

Function: http-post-check (path &rest params) ¶

Package

webdriver-client.

Source

http.lisp.

Function: http-post-value (path &rest params) ¶

Package

webdriver-client.

Source

http.lisp.

Function: keyword-plist-p (list) ¶

Check if LIST is a property list with keyword keys.

Package

webdriver-client.

Source

session.lisp.

Function: make-uri (path) ¶

Package

webdriver-client.

Source

http.lisp.

Function: plist-p (list) ¶

Check if LIST is a property list.

Package

webdriver-client.

Source

session.lisp.

Function: protocol-error-error (error) ¶

Package

webdriver-client.

Source

errors.lisp.

Function: serialize-capabilities (capabilities) ¶

Package

webdriver-client.

Source

capabilities.lisp.

Function: session-path (session fmt &rest args) ¶

Package

webdriver-client.

Source

session.lisp.

Function: set-window-rect (&key x y width height session) ¶

Package

webdriver-client.

Source

window.lisp.

Function: value (response) ¶

Package

webdriver-client.

Source

http.lisp.

---

6.2.4 Generic functions

Generic Reader: protocol-error-body (condition) ¶

Package

webdriver-client.

Methods

Reader Method: protocol-error-body ((condition protocol-error)) ¶

Source

errors.lisp.

Target Slot

body.

Generic Reader: protocol-error-status (condition) ¶

Package

webdriver-client.

Methods

Reader Method: protocol-error-status ((condition protocol-error)) ¶

Source

errors.lisp.

Target Slot

status.

Generic Reader: session-id (object) ¶

Package

webdriver-client.

Methods

Reader Method: session-id ((session session)) ¶

automatically generated reader method

Source

session.lisp.

Target Slot

id.

---

6.2.5 Conditions

Condition: find-error ¶

Package

webdriver-client.

Source

errors.lisp.

Direct superclasses

error.

Direct subclasses

• no-such-element-error.
• stale-element-reference.

Direct slots

Slot: value ¶

Initargs

:value

Slot: by ¶

Initargs

:by

Condition: protocol-error ¶

Package

webdriver-client.

Source

errors.lisp.

Direct superclasses

error.

Direct methods

• print-object.
• protocol-error-body.
• protocol-error-status.

Direct slots

Slot: body ¶

Initargs

:body

Readers

protocol-error-body.

Writers

This slot is read-only.

Slot: status ¶

Initargs

:status

Readers

protocol-error-status.

Writers

This slot is read-only.

Condition: stale-element-reference ¶

Package

webdriver-client.

Source

errors.lisp.

Direct superclasses

find-error.

---

6.2.6 Structures

Structure: capabilities ¶

Package

webdriver-client.

Source

capabilities.lisp.

Direct superclasses

structure-object.

Direct slots

Slot: always-match ¶

Readers

capabilities-always-match.

Writers

(setf capabilities-always-match).

Slot: first-match ¶

Readers

capabilities-first-match.

Writers

(setf capabilities-first-match).

---

6.2.7 Classes

Class: element ¶

Package

webdriver-client.

Source

webdriver.lisp.

Direct methods

• element-id.
• print-object.

Direct slots

Slot: id ¶

Initform

(error "must supply :id")

Initargs

:id

Readers

element-id.

Writers

This slot is read-only.

Class: session ¶

A Selenium Webdriver session.

The server should maintain one browser per session. Commands sent to a session will be directed to the corresponding browser.

Package

webdriver-client.

Source

session.lisp.

Direct methods

• print-object.
• session-id.

Direct slots

Slot: id ¶

Initform

(error "must supply an id")

Initargs

:id

Readers

session-id.

Writers

This slot is read-only.

---

6.2.8 Types

Type: element-location-strategy () ¶

An element location strategy is an enumerated attribute deciding what technique should be used to search for elements in the current browsing context. See: https://www.w3.org/TR/webdriver1/#dfn-strategy .

Package

webdriver-client.

Source

webdriver.lisp.

---