Narrow browser-backend abstraction shared by the Playwright and iOS application (Appium/WebDriver) providers.
Covers only the common agent-facing surface: navigate, snapshot,
click/fill/clear, evaluate, screenshot, history, cookies, tap/swipe.
Playwright-specific advanced APIs (CDP, tracing, HAR, routing, frames,
tabs, ...) intentionally stay OUTSIDE the protocol — callers must check
backend-capabilities and fail with an explicit capability error.
Ref actions (@e2yrjz) resolve through the shared snapshot
data-pw-ref attribute system on both backends.
Narrow browser-backend abstraction shared by the Playwright and iOS application (Appium/WebDriver) providers. Covers only the common agent-facing surface: navigate, snapshot, click/fill/clear, evaluate, screenshot, history, cookies, tap/swipe. Playwright-specific advanced APIs (CDP, tracing, HAR, routing, frames, tabs, ...) intentionally stay OUTSIDE the protocol — callers must check `backend-capabilities` and fail with an explicit capability error. Ref actions (`@e2yrjz`) resolve through the shared snapshot `data-pw-ref` attribute system on both backends.
(evaluate! backend script args)Evaluates JavaScript, returning the decoded result.
Evaluates JavaScript, returning the decoded result.
(click! backend selector opts)Clicks the element for a CSS selector or @ref.
Clicks the element for a CSS selector or @ref.
(current-url backend)Returns the current URL string.
Returns the current URL string.
(backend-kind backend)Returns a keyword identifying the backend (:playwright or :ios).
Returns a keyword identifying the backend (:playwright or :ios).
(tap! backend selector-or-coords opts)Performs a native touch tap on a selector/@ref or [x y] coordinates.
Performs a native touch tap on a selector/@ref or [x y] coordinates.
(close-backend! backend)Closes backend-owned resources. Idempotent.
Closes backend-owned resources. Idempotent.
(swipe! backend opts)Performs a native touch swipe ({:direction ...} or {:from ... :to ...}).
Performs a native touch swipe ({:direction ...} or {:from ... :to ...}).
(cookies backend)Returns the cookie list.
Returns the cookie list.
(fill! backend selector value opts)Clears then fills the element for a CSS selector or @ref.
Clears then fills the element for a CSS selector or @ref.
(reload! backend)Reloads the current page.
Reloads the current page.
(navigate! backend url opts)Navigates to url. Returns {:url current-url}.
Navigates to `url`. Returns {:url current-url}.
(clear! backend selector opts)Clears the element for a CSS selector or @ref.
Clears the element for a CSS selector or @ref.
(backend-capabilities backend)Returns the set of supported capability keywords.
Returns the set of supported capability keywords.
(go-forward! backend)History forward.
History forward.
(page-title backend)Returns the current page title string.
Returns the current page title string.
(capture-snapshot! backend opts)Captures a spel accessibility snapshot. Returns the snapshot map.
Captures a spel accessibility snapshot. Returns the snapshot map.
(screenshot! backend opts)Returns PNG screenshot bytes.
Returns PNG screenshot bytes.
(page-content backend)Returns the page HTML source string.
Returns the page HTML source string.
(go-back! backend)History back.
History back.
(ios-backend ios-session)Wraps an ios/IosSession in an IosAppBackend.
Wraps an ios/IosSession in an IosAppBackend.
Capabilities supported by the iOS application (WebDriver) backend. Web-only capabilities become usable after switching to a WEBVIEW context.
Capabilities supported by the iOS application (WebDriver) backend. Web-only capabilities become usable after switching to a WEBVIEW context.
(playwright-backend pw-page)Wraps a Playwright Page in a PlaywrightBackend.
Wraps a Playwright Page in a PlaywrightBackend.
Capabilities supported by the Playwright backend.
Capabilities supported by the Playwright backend.
(ref-selector? s)Returns true when a selector string is a snapshot ref (@e2yrjz).
Returns true when a selector string is a snapshot ref (@e2yrjz).
(resolve-css selector)Resolves a selector-or-ref to a plain CSS selector. Refs become [data-pw-ref="..."] selectors; CSS passes through.
Resolves a selector-or-ref to a plain CSS selector. Refs become [data-pw-ref="..."] selectors; CSS passes through.
(stale-ref-error selector cause)Builds the standard stale-ref ex-info for a missing @ref.
Builds the standard stale-ref ex-info for a missing @ref.
(supports? backend capability)Returns true when the backend supports a capability keyword.
Returns true when the backend supports a capability keyword.
(unsupported! backend operation)(unsupported! backend operation alternative)Throws the standard capability error for an unsupported operation.
Params:
backend - the active backend (for kind + capability set).
operation - String. The command/operation name.
alternative - String, optional. Suggested alternative.
Throws the standard capability error for an unsupported operation. Params: `backend` - the active backend (for kind + capability set). `operation` - String. The command/operation name. `alternative` - String, optional. Suggested alternative.
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |