SCI (Small Clojure Interpreter) environment for native-image REPL.
Registers all spel functions as SCI namespaces so they can be evaluated in a native-image compiled REPL without JVM startup.
The SCI context wraps a stateful Playwright session with managed atoms for the Playwright, Browser, BrowserContext, and Page instances.
Namespaces available in eval-sci mode: spel/ - Simplified API (implicit page/context from atoms) snapshot/ - Accessibility snapshot capture annotate/ - Screenshot annotation input/ - Keyboard, Mouse, Touchscreen (raw pass-throughs) frame/ - Frame and FrameLocator operations (raw pass-throughs) net/ - Network request/response/route (raw pass-throughs) loc/ - Locator operations (raw pass-throughs, explicit Locator arg) assert/ - Assertion functions (raw pass-throughs, explicit assertion obj) core/ - Lifecycle stubs + utility pass-throughs
Usage: (def ctx (create-sci-ctx)) (eval-string ctx "(spel/start!)") (eval-string ctx "(spel/navigate "https://example.org")") (eval-string ctx "(spel/capture-snapshot)") (eval-string ctx "(spel/stop!)")
SCI (Small Clojure Interpreter) environment for native-image REPL. Registers all spel functions as SCI namespaces so they can be evaluated in a native-image compiled REPL without JVM startup. The SCI context wraps a stateful Playwright session with managed atoms for the Playwright, Browser, BrowserContext, and Page instances. Namespaces available in eval-sci mode: spel/ - Simplified API (implicit page/context from atoms) snapshot/ - Accessibility snapshot capture annotate/ - Screenshot annotation input/ - Keyboard, Mouse, Touchscreen (raw pass-throughs) frame/ - Frame and FrameLocator operations (raw pass-throughs) net/ - Network request/response/route (raw pass-throughs) loc/ - Locator operations (raw pass-throughs, explicit Locator arg) assert/ - Assertion functions (raw pass-throughs, explicit assertion obj) core/ - Lifecycle stubs + utility pass-throughs Usage: (def ctx (create-sci-ctx)) (eval-string ctx "(spel/start!)") (eval-string ctx "(spel/navigate \"https://example.org\")") (eval-string ctx "(spel/capture-snapshot)") (eval-string ctx "(spel/stop!)")
(create-sci-ctx)Creates a SCI context with all spel functions registered.
The context includes:
pw namespace: All REPL functions (start!, stop!, goto, click, etc.)snapshot namespace: Snapshot capture and ref resolutionannotate namespace: Screenshot annotationinput namespace: Keyboard, Mouse, Touchscreen operationsframe namespace: Frame and FrameLocator operationsnet namespace: Network request/response/route operationsloc namespace: Raw locator operations (explicit Locator arg)assert namespace: Raw assertion operations (explicit assertion obj)core namespace: Lifecycle stubs + utility pass-throughsAll Playwright Java classes are registered for interop.
Returns: SCI context ready for evaluation.
Creates a SCI context with all spel functions registered. The context includes: - `pw` namespace: All REPL functions (start!, stop!, goto, click, etc.) - `snapshot` namespace: Snapshot capture and ref resolution - `annotate` namespace: Screenshot annotation - `input` namespace: Keyboard, Mouse, Touchscreen operations - `frame` namespace: Frame and FrameLocator operations - `net` namespace: Network request/response/route operations - `loc` namespace: Raw locator operations (explicit Locator arg) - `assert` namespace: Raw assertion operations (explicit assertion obj) - `core` namespace: Lifecycle stubs + utility pass-throughs All Playwright Java classes are registered for interop. Returns: SCI context ready for evaluation.
(eval-string ctx code)Evaluates a Clojure string in the SCI context.
Binds SCI's out/err/in to the JVM equivalents so that
println, prn, etc. work correctly in eval-sci mode.
Params:
ctx - SCI context from create-sci-ctx.
code - String. Clojure code to evaluate.
Returns: Result of evaluation.
When SCI cannot resolve a symbol, appends a 'did you mean?' hint: the same
name with a trailing ! (spel's mutator convention) when that resolves, so
set-viewport-size points at set-viewport-size!, otherwise the namespace
that really binds the name, so spel/with-retry points at
core/with-retry.
Evaluates a Clojure string in the SCI context. Binds SCI's *out*/*err*/*in* to the JVM equivalents so that `println`, `prn`, etc. work correctly in eval-sci mode. Params: `ctx` - SCI context from create-sci-ctx. `code` - String. Clojure code to evaluate. Returns: Result of evaluation. When SCI cannot resolve a symbol, appends a 'did you mean?' hint: the same name with a trailing `!` (spel's mutator convention) when that resolves, so `set-viewport-size` points at `set-viewport-size!`, otherwise the namespace that really binds the name, so `spel/with-retry` points at `core/with-retry`.
(sci-$ sel-or-loc)(sci-$$ sel)(sci-$alt-text text)(sci-$label text)(sci-$placeholder text)(sci-$ref ref-id)Locates an element by its snapshot ref ID (e.g. "@e2yrjz", "@e9mter").
Locates an element by its snapshot ref ID (e.g. "@e2yrjz", "@e9mter").
(sci-$role role)(sci-$role role opts)(sci-$test-id id)(sci-$text text)(sci-$title-attr text)(sci-action-log)Returns the current action log entries. Each entry is a map with :idx, :timestamp, :action, :target, :args.
Returns the current action log entries. Each entry is a map with :idx, :timestamp, :action, :target, :args.
(sci-add-init-script! script)Registers a JavaScript string to run on every navigation of the current page. Returns the page for threading.
Registers a JavaScript string to run on every navigation of the current page. Returns the page for threading.
(sci-add-init-script-file! path)Registers a JavaScript file to run on every navigation of the current page. Returns the page for threading.
Registers a JavaScript file to run on every navigation of the current page. Returns the page for threading.
(sci-add-script-tag opts)(sci-add-style-tag opts)(sci-all-inner-texts sel)(sci-all-text-contents sel)(sci-annotate refs)(sci-annotate refs opts)Injects annotation overlays into the current page for visible elements. Takes refs from snapshot and optional display opts.
Injects annotation overlays into the current page for visible elements. Takes refs from snapshot and optional display opts.
(sci-annotated-screenshot refs)(sci-annotated-screenshot refs opts)(sci-anti-detection-headers ua)Returns anti-detection HTTP headers matched to a user-agent string.
Returns anti-detection HTTP headers matched to a user-agent string.
(sci-assert-accessible-description sel desc)(sci-assert-accessible-error-message sel msg)(sci-assert-accessible-name sel name-val)(sci-assert-attached sel)(sci-assert-attached sel opts)(sci-assert-attr sel attr-name value)(sci-assert-attr sel attr-name value opts)(sci-assert-checked sel)(sci-assert-checked sel opts)(sci-assert-class sel class-val)(sci-assert-class sel class-val opts)(sci-assert-contains-class sel class-val)(sci-assert-contains-class sel class-val opts)(sci-assert-contains-text sel expected)(sci-assert-contains-text sel expected opts)(sci-assert-count sel n)(sci-assert-count sel n opts)(sci-assert-css sel css-name value)(sci-assert-css sel css-name value opts)(sci-assert-disabled sel)(sci-assert-disabled sel opts)(sci-assert-editable sel)(sci-assert-editable sel opts)(sci-assert-empty sel)(sci-assert-enabled sel)(sci-assert-enabled sel opts)(sci-assert-focused sel)(sci-assert-focused sel opts)(sci-assert-hidden sel)(sci-assert-hidden sel opts)(sci-assert-id sel id)(sci-assert-id sel id opts)(sci-assert-in-viewport sel)(sci-assert-in-viewport sel opts)(sci-assert-js-property sel prop-name value)(sci-assert-matches-aria-snapshot sel snapshot-str)(sci-assert-not sel)(sci-assert-page-not)(sci-assert-role sel role)(sci-assert-text sel expected)(sci-assert-text sel expected opts)(sci-assert-that target)(sci-assert-title expected)(sci-assert-title expected opts)(sci-assert-url expected)(sci-assert-url expected opts)(sci-assert-value sel value)(sci-assert-value sel value opts)(sci-assert-values sel values)(sci-assert-values sel values opts)(sci-assert-visible sel)(sci-assert-visible sel opts)(sci-attr sel name)(sci-audit-screenshot caption)(sci-audit-screenshot caption opts)Takes a screenshot with a caption bar at the bottom.
Takes a screenshot with a caption bar at the bottom.
(sci-auto-accept-dialogs!)(sci-auto-accept-dialogs! prompt-text)Registers a persistent dialog handler that auto-accepts all dialogs. Optional prompt-text for prompt dialogs. Removes any previous handler first. Returns nil.
Registers a persistent dialog handler that auto-accepts all dialogs. Optional prompt-text for prompt dialogs. Removes any previous handler first. Returns nil.
(sci-auto-dismiss-dialogs!)Registers a persistent dialog handler that auto-dismisses all dialogs. Removes any previous handler first. Returns nil.
Registers a persistent dialog handler that auto-dismisses all dialogs. Removes any previous handler first. Returns nil.
(sci-back)Goes back in browser history (backend-aware).
Goes back in browser history (backend-aware).
(sci-bbox sel)(sci-blur sel)(sci-bring-to-front)(sci-browser)Returns the current Browser instance.
Returns the current Browser instance.
(sci-browser-connected?)(sci-browser-version)(sci-cdp-connect)(sci-cdp-connect url)Connects to a Chrome/Edge browser via CDP (Chrome DevTools Protocol).
With a URL argument, connects to that specific endpoint: (spel/cdp-connect "http://192.168.1.50:9222")
Without arguments, auto-discovers the best endpoint:
This is the recommended entry point for CDP connections — it handles WSL networking, host resolution, and Chrome discovery automatically.
Examples: (spel/cdp-connect) ;; auto-discover (spel/cdp-connect "http://10.1.0.1:9222") ;; explicit host (spel/cdp-connect "ws://localhost:9222/devtools/browser/abc") ;; WS
Returns: Map with :connected URL, :url current page URL.
Connects to a Chrome/Edge browser via CDP (Chrome DevTools Protocol). With a URL argument, connects to that specific endpoint: (spel/cdp-connect "http://192.168.1.50:9222") Without arguments, auto-discovers the best endpoint: - On WSL: probes both 127.0.0.1 and the Windows host gateway IP (from /proc/net/route), uses whichever answers /json/version - On native Linux/macOS: probes 127.0.0.1 on ports 9222, 9229 - Throws with clear instructions if no browser is found This is the recommended entry point for CDP connections — it handles WSL networking, host resolution, and Chrome discovery automatically. Examples: (spel/cdp-connect) ;; auto-discover (spel/cdp-connect "http://10.1.0.1:9222") ;; explicit host (spel/cdp-connect "ws://localhost:9222/devtools/browser/abc") ;; WS Returns: Map with :connected URL, :url current page URL.
(sci-cdp-disconnect)Temporarily disconnects from the CDP endpoint.
Used in anti-detection scripts to evade CDP watchers. The Chrome process keeps running; only the debugging protocol link is dropped. Call cdp-reconnect to reattach.
Returns: Map with :disconnected boolean and :cdp URL string.
Example: (spel/cdp-disconnect) (spel/sleep 3000) ; browser runs unmonitored (spel/cdp-reconnect)
Temporarily disconnects from the CDP endpoint. Used in anti-detection scripts to evade CDP watchers. The Chrome process keeps running; only the debugging protocol link is dropped. Call cdp-reconnect to reattach. Returns: Map with :disconnected boolean and :cdp URL string. Example: (spel/cdp-disconnect) (spel/sleep 3000) ; browser runs unmonitored (spel/cdp-reconnect)
(sci-cdp-idle-timeout)Returns the current CDP idle timeout in milliseconds.
After CDP disconnect, the daemon auto-shuts down if no reconnect occurs within this window. 0 means disabled. Default: 1800000 (30 min). Set SPEL_CDP_IDLE_TIMEOUT env var or call (spel/set-cdp-idle-timeout! ms).
Returns the current CDP idle timeout in milliseconds. After CDP disconnect, the daemon auto-shuts down if no reconnect occurs within this window. 0 means disabled. Default: 1800000 (30 min). Set SPEL_CDP_IDLE_TIMEOUT env var or call (spel/set-cdp-idle-timeout! ms).
(sci-cdp-lock-wait)Returns the current CDP route lock wait timeout in seconds.
When another session holds the CDP route lock, the daemon waits up to this many seconds for the lock to be released before failing. 0 means fail immediately. Default: 120 (2 minutes). Set SPEL_CDP_LOCK_WAIT env var or call (spel/set-cdp-lock-wait! s).
Returns the current CDP route lock wait timeout in seconds. When another session holds the CDP route lock, the daemon waits up to this many seconds for the lock to be released before failing. 0 means fail immediately. Default: 120 (2 minutes). Set SPEL_CDP_LOCK_WAIT env var or call (spel/set-cdp-lock-wait! s).
(sci-cdp-reconnect)(sci-cdp-reconnect url)Reconnects to the CDP endpoint after a disconnect.
No arguments needed — the daemon remembers the CDP URL from the original connection. An explicit URL override is accepted but almost never required.
Returns: Map with :connected URL, :url current page URL, :reconnected true.
Example: (spel/cdp-disconnect) (spel/sleep 3000) (spel/cdp-reconnect) ; just works — daemon knows the URL (spel/cdp-reconnect "ws://localhost:9222") ; explicit override
Reconnects to the CDP endpoint after a disconnect. No arguments needed — the daemon remembers the CDP URL from the original connection. An explicit URL override is accepted but almost never required. Returns: Map with :connected URL, :url current page URL, :reconnected true. Example: (spel/cdp-disconnect) (spel/sleep 3000) (spel/cdp-reconnect) ; just works — daemon knows the URL (spel/cdp-reconnect "ws://localhost:9222") ; explicit override
(sci-check sel)(sci-check sel opts)(sci-checked? sel)(sci-clear sel)Clears an input (backend-aware).
Clears an input (backend-aware).
(sci-clear-action-log!)Clears the action log, resetting the counter and start time.
Clears the action log, resetting the counter and start time.
(sci-clear-dialog-handler!)Removes the current auto-accept/auto-dismiss dialog handler. Returns nil.
Removes the current auto-accept/auto-dismiss dialog handler. Returns nil.
(sci-clear-refs!)(sci-click sel)(sci-click sel opts)(sci-clipboard-copy text)Writes text to the browser clipboard.
Writes text to the browser clipboard.
(sci-clipboard-paste)Pastes clipboard contents into the currently focused element.
Pastes clipboard contents into the currently focused element.
(sci-clipboard-read)Reads text from the browser clipboard.
Reads text from the browser clipboard.
(sci-compare-pages baseline-page current-page)(sci-compare-pages baseline-page current-page opts)Compare two live pages: screenshot + snapshot + diff with semantic enrichment. Returns enriched regions with element labels.
Compare two live pages: screenshot + snapshot + diff with semantic enrichment. Returns enriched regions with element labels.
(sci-compare-screenshot-files baseline-path current-path)(sci-compare-screenshot-files baseline-path current-path opts)Compare two PNG files pixel-by-pixel. See compare-screenshots for details.
Compare two PNG files pixel-by-pixel. See compare-screenshots for details.
(sci-compare-screenshots baseline-bytes current-bytes)(sci-compare-screenshots baseline-bytes current-bytes opts)Compare two PNG screenshots pixel-by-pixel using pixelmatch. Returns {:matched :diff-count :diff-percent :diff-image ...}.
Compare two PNG screenshots pixel-by-pixel using pixelmatch.
Returns {:matched :diff-count :diff-percent :diff-image ...}.(sci-context)Returns the current BrowserContext instance.
Returns the current BrowserContext instance.
(sci-context-clear-cookies!)Clears all cookies (Playwright only — the iOS backend exposes read-only cookie access).
Clears all cookies (Playwright only — the iOS backend exposes read-only cookie access).
(sci-context-clear-permissions!)(sci-context-cookies)Returns the cookie list. Backend-aware: reads Safari's cookies through WebDriver on the iOS backend, the BrowserContext on Playwright.
Returns the cookie list. Backend-aware: reads Safari's cookies through WebDriver on the iOS backend, the BrowserContext on Playwright.
(sci-context-grant-permissions! perms)(sci-context-route-from-har! har)(sci-context-route-from-har! har opts)(sci-context-route-web-socket! pattern handler)(sci-context-save-storage-state! path)(sci-context-set-extra-http-headers! headers)(sci-context-set-offline! offline)(sci-context-storage-state)(sci-count-of sel)(sci-dblclick sel)(sci-dblclick sel opts)(sci-ddg-search! query)Searches DuckDuckGo and returns structured results.
Searches DuckDuckGo and returns structured results.
(sci-debug)Collects page diagnostics: performance timing, failed resources, DOM stats, dimensions. Returns map with :url :title :ready-state :timing :failed-resources :dom :dimensions.
Collects page diagnostics: performance timing, failed resources, DOM stats, dimensions. Returns map with :url :title :ready-state :timing :failed-resources :dom :dimensions.
(sci-dialog-accept! dialog)(sci-dialog-accept! dialog prompt-text)Accepts the dialog. Optional prompt-text for prompt dialogs.
Accepts the dialog. Optional prompt-text for prompt dialogs.
(sci-dialog-default-value dialog)Returns the default value for prompt dialogs.
Returns the default value for prompt dialogs.
(sci-dialog-dismiss! dialog)Dismisses the dialog.
Dismisses the dialog.
(sci-dialog-message dialog)Returns the dialog message text.
Returns the dialog message text.
(sci-dialog-type dialog)Returns the dialog type (alert, confirm, prompt, beforeunload).
Returns the dialog type (alert, confirm, prompt, beforeunload).
(sci-disabled? sel)(sci-dispatch-event sel type)(sci-drag-by sel dx dy)(sci-drag-by sel dx dy opts)Drags an element by pixel offset using mouse events. Resolves selector to locator, gets bounding box center, then performs: move → mousedown → mousemove(+dx,+dy) → mouseup.
Drags an element by pixel offset using mouse events. Resolves selector to locator, gets bounding box center, then performs: move → mousedown → mousemove(+dx,+dy) → mouseup.
(sci-drag-to sel target-sel)(sci-drag-to sel target-sel opts)Drags an element to another element. Resolves both selectors to locators via the current page.
Drags an element to another element. Resolves both selectors to locators via the current page.
(sci-duckduckgo-url query)Builds a DuckDuckGo search URL from a query string.
Builds a DuckDuckGo search URL from a query string.
(sci-editable? sel)(sci-emulate-media! opts)(sci-enabled? sel)(sci-eval-js expr)(sci-eval-js expr arg)(sci-evaluate-all-locs sel expr)(sci-evaluate-all-locs sel expr arg)(sci-evaluate-file path)(sci-evaluate-file path arg)Loads JavaScript from a file and evaluates it in the current page. Returns the evaluation result converted to Clojure data.
Loads JavaScript from a file and evaluates it in the current page. Returns the evaluation result converted to Clojure data.
(sci-evaluate-handle expr)(sci-evaluate-handle expr arg)(sci-evaluate-locator sel expr)(sci-evaluate-locator sel expr arg)(sci-export-srt)(sci-export-srt opts)Exports the current action log as an SRT subtitle string. Options: :min-duration-ms Minimum cue duration (default: 1000) :max-duration-ms Maximum cue duration (default: 5000)
Exports the current action log as an SRT subtitle string. Options: :min-duration-ms Minimum cue duration (default: 1000) :max-duration-ms Maximum cue duration (default: 5000)
(sci-expose-binding! binding-name f)(sci-expose-function! fn-name f)(sci-extract-image-results)(sci-extract-news-results)(sci-extract-people-also-ask)(sci-extract-related-searches)(sci-extract-result-stats)(sci-extract-web-results)(sci-fill sel value)(sci-fill sel value opts)(sci-find-free-port)Returns an available local TCP port (integer).
Delegates to core/find-free-port and throws on anomaly.
Returns an available local TCP port (integer). Delegates to core/find-free-port and throws on anomaly.
(sci-finish-video-recording)(sci-finish-video-recording opts)Stops video recording by closing the context to finalize the video. Returns the video file path. Creates a new context/page without video.
Opts: :save-as - String. Copy video to this path after finalization.
Stops video recording by closing the context to finalize the video. Returns the video file path. Creates a new context/page without video. Opts: :save-as - String. Copy video to this path after finalization.
(sci-first sel)(sci-focus sel)(sci-format-results-as-markdown search-type results)Formats search results as a markdown table based on search type.
Formats search results as a markdown table based on search type.
(sci-forward)Goes forward in browser history (backend-aware).
Goes forward in browser history (backend-aware).
(sci-frame-by-name name)(sci-frame-by-url pattern)(sci-frames)(sci-full-snapshot)(sci-full-snapshot page)(sci-get-styles sel)(sci-get-styles sel opts)Returns computed CSS styles for an element. Pass {:full true} for all properties.
Returns computed CSS styles for an element. Pass {:full true} for all properties.
(sci-goto url)(sci-goto url opts)Navigates the current page to a URL. Validates the URL before navigation — throws on invalid URLs. Dispatches through the active backend when one is installed (iOS).
Navigates the current page to a URL. Validates the URL before navigation — throws on invalid URLs. Dispatches through the active backend when one is installed (iOS).
(sci-has-next-page?)(sci-help)(sci-help query)Lists all available SCI eval functions with arglists and descriptions. Call with no args to see all namespaces summary. Call with a namespace name to see all functions in that namespace. Call with a search string to find matching functions.
Lists all available SCI eval functions with arglists and descriptions. Call with no args to see all namespaces summary. Call with a namespace name to see all functions in that namespace. Call with a search string to find matching functions.
(sci-hidden? sel)(sci-highlight sel)(sci-hover sel)(sci-hover sel opts)(sci-html)Returns the current page HTML source (backend-aware).
Returns the current page HTML source (backend-aware).
(sci-human-pause)(sci-human-pause min-ms max-ms)Pauses for a random duration between min-ms and max-ms (default: 300-700ms). Simulates natural human pacing for smoother video recordings.
Usage: (spel/human-pause) ;; 300-700ms (spel/human-pause 500 1000) ;; 500-1000ms
Pauses for a random duration between min-ms and max-ms (default: 300-700ms). Simulates natural human pacing for smoother video recordings. Usage: (spel/human-pause) ;; 300-700ms (spel/human-pause 500 1000) ;; 500-1000ms
(sci-info)Returns a map with current page :url, :title, :viewport, and :closed? state.
Returns a map with current page :url, :title, :viewport, and :closed? state.
(sci-inner-html sel)(sci-inner-text sel)(sci-inspect)(sci-inspect opts)Takes interactive snapshot with styles - the 'agent view'. Returns snapshot map with :tree :refs :counter :viewport.
Takes interactive snapshot with styles - the 'agent view'. Returns snapshot map with :tree :refs :counter :viewport.
(sci-ios-activate-app!)(sci-ios-activate-app! bundle-id)Activates the bound or requested installed iOS application.
Activates the bound or requested installed iOS application.
(sci-ios-app-installed? bundle-id)Returns true when an iOS application is installed.
Returns true when an iOS application is installed.
(sci-ios-app-state bundle-id)Returns the state of an installed iOS application as a keyword.
Returns the state of an installed iOS application as a keyword.
(sci-ios-background-app!)(sci-ios-background-app! seconds)Moves the active iOS application to the background for N seconds.
Moves the active iOS application to the background for N seconds.
(sci-ios-context-details)Returns detailed context records, including webview URL/title metadata when available.
Returns detailed context records, including webview URL/title metadata when available.
(sci-ios-contexts)Returns available iOS automation contexts (NATIVE_APP and inspectable WEBVIEW_* contexts).
Returns available iOS automation contexts (NATIVE_APP and inspectable WEBVIEW_* contexts).
(sci-ios-current-context)Returns the active iOS automation context name.
Returns the active iOS automation context name.
(sci-ios-devices)Lists available iOS Simulators without requiring an active session.
Lists available iOS Simulators without requiring an active session.
(sci-ios-doctor)Runs iOS provider prerequisite diagnostics without installing software.
Runs iOS provider prerequisite diagnostics without installing software.
(sci-ios-hide-keyboard!)Dismisses the iOS software keyboard.
Dismisses the iOS software keyboard.
(sci-ios-install-app! path)Installs a simulator-compatible .app.
Installs a simulator-compatible .app.
(sci-ios-launch-app!)(sci-ios-launch-app! bundle-id)Launches the bound or requested installed iOS application.
Launches the bound or requested installed iOS application.
(sci-ios-open-url! url)(sci-ios-open-url! url bundle-id)Opens a deep or universal URL.
Opens a deep or universal URL.
(sci-ios-orientation)Returns the current iOS device orientation as :portrait or :landscape.
Returns the current iOS device orientation as :portrait or :landscape.
(sci-ios-permission service)(sci-ios-permission bundle-id service)Returns an iOS application permission value.
Returns an iOS application permission value.
(sci-ios-set-orientation! requested)Rotates the iOS device to :portrait or :landscape.
Rotates the iOS device to :portrait or :landscape.
(sci-ios-set-permission! service access)(sci-ios-set-permission! bundle-id service access)Sets an app permission. Access accepts :grant, :revoke, or :reset.
Sets an app permission. Access accepts :grant, :revoke, or :reset.
(sci-ios-start! opts)Starts an Appium/XCUITest application session in an iOS Simulator and installs it as the active backend. Called by (spel/start! {:provider :ios :bundle-id "com.example.app"}).
Opts: :device, :udid, :platform-version, :bundle-id, :app, :extra-capabilities, :appium-url, :session.
Starts an Appium/XCUITest application session in an iOS Simulator and
installs it as the active backend. Called by
(spel/start! {:provider :ios :bundle-id "com.example.app"}).
Opts: :device, :udid, :platform-version, :bundle-id, :app,
:extra-capabilities, :appium-url, :session.(sci-ios-tap-dom! x y)Taps a WEB-VIEWPORT coordinate (CSS pixels) as a native XCUITest gesture.
Taps a WEB-VIEWPORT coordinate (CSS pixels) as a native XCUITest gesture.
(sci-ios-tap-element! css)Taps the element matching a CSS selector inside the app's WebView, natively.
Taps the element matching a CSS selector inside the app's WebView, natively.
(sci-ios-terminate-app!)(sci-ios-terminate-app! bundle-id)Terminates the bound or requested iOS application.
Terminates the bound or requested iOS application.
(sci-ios-type-keys! text)(sci-ios-type-keys! selector text)Types through XCTest keyboard events so native iOS IME/autocorrection runs.
Types through XCTest keyboard events so native iOS IME/autocorrection runs.
(sci-ios-uninstall-app! bundle-id)Uninstalls an iOS application by bundle identifier.
Uninstalls an iOS application by bundle identifier.
(sci-ios-viewport-offset)Returns the native-point offset of the app's web viewport on the screen.
Returns the native-point offset of the app's web viewport on the screen.
(sci-json-write-str data)Serializes Clojure data to a JSON string for eval-sci scripts.
Serializes Clojure data to a JSON string for eval-sci scripts.
(sci-keyboard)(sci-keyboard-press key)Presses a key on the focused page/native element.
Presses a key on the focused page/native element.
(sci-last sel)(sci-last-response url)Navigates to URL and returns response info map with :status, :ok?, :url, :headers.
Navigates to URL and returns response info map with :status, :ok?, :url, :headers.
(sci-launch-chromium _pw & _opts)In daemon mode, returns the daemon's existing browser instance.
In daemon mode, returns the daemon's existing browser instance.
(sci-launch-firefox _pw & _opts)In daemon mode, returns the daemon's existing browser instance.
In daemon mode, returns the daemon's existing browser instance.
(sci-launch-webkit _pw & _opts)In daemon mode, returns the daemon's existing browser instance.
In daemon mode, returns the daemon's existing browser instance.
(sci-loc-filter sel opts)(sci-loc-get-by-label sel text)(sci-loc-get-by-role sel role)(sci-loc-get-by-test-id sel id)(sci-loc-get-by-text sel text)(sci-loc-locator sel sub-sel)(sci-loc-wait-for sel)(sci-loc-wait-for sel opts)(sci-locator-screenshot sel)(sci-locator-screenshot sel opts)(sci-main-frame)(sci-mark & refs)Highlights specific snapshot refs with prominent pre-action markers (e.g. "@e2yrjz").
Highlights specific snapshot refs with prominent pre-action markers (e.g. "@e2yrjz").
(sci-markdownify)(sci-markdownify html)Converts the current page HTML into Markdown.
Converts the current page HTML into Markdown.
(sci-mouse)(sci-net-requests)Returns the daemon-tracked network request summaries when available. In standalone SCI contexts without the daemon request ring buffer, returns [].
Returns the daemon-tracked network request summaries when available. In standalone SCI contexts without the daemon request ring buffer, returns [].
(sci-new-cdp-session)Opens a new Chrome DevTools Protocol session bound to the current
page. Pair with cdp-send, cdp-on, cdp-detach!.
Opens a new Chrome DevTools Protocol session bound to the current page. Pair with `cdp-send`, `cdp-on`, `cdp-detach!`.
(sci-new-context _browser & _opts)In daemon mode, returns the daemon's existing browser context.
In daemon mode, returns the daemon's existing browser context.
(sci-new-page _browser)In daemon mode, returns the daemon's existing page.
In daemon mode, returns the daemon's existing page.
(sci-new-page-from-context _ctx)In daemon mode, returns the daemon's existing page.
In daemon mode, returns the daemon's existing page.
(sci-new-tab!)Opens a new tab in the current context and switches to it.
Opens a new tab in the current context and switches to it.
(sci-nth sel n)(sci-off-dialog listener)Removes a dialog handler, taking the listener on-dialog returned.
Playwright unregisters by object identity, so the handler function itself
removes nothing — pass back what (spel/on-dialog ...) answered.
Removes a dialog handler, taking the listener `on-dialog` returned. Playwright unregisters by object identity, so the handler function itself removes nothing — pass back what `(spel/on-dialog ...)` answered.
(sci-on-close handler)(sci-on-console handler)(sci-on-dialog handler)(sci-on-download handler)(sci-on-page-error handler)(sci-on-popup handler)(sci-on-request handler)(sci-on-response handler)(sci-once-dialog handler)(sci-overview)(sci-overview opts)Takes an annotated full-page screenshot by default. Pass :full-page false for the current viewport. Opts: :path :full-page :show-badges :show-dimensions :show-boxes :scope :all-frames?. Returns {:bytes :annotated} or {:path :size :annotated}.
Takes an annotated full-page screenshot by default. Pass :full-page false for the current viewport.
Opts: :path :full-page :show-badges :show-dimensions :show-boxes :scope :all-frames?.
Returns {:bytes :annotated} or {:path :size :annotated}.(sci-page)Returns the current Page instance.
Returns the current Page instance.
(sci-page-context)(sci-pdf)(sci-pdf path-or-opts)(sci-press key)(sci-press sel key)(sci-press sel key opts)Presses a key. Single-arg form targets the focused element. Two-arg form targets a selector or snapshot ref.
Presses a key. Single-arg form targets the focused element. Two-arg form targets a selector or snapshot ref.
(sci-pw-create)No-op in daemon mode — Playwright instance is managed by the daemon.
No-op in daemon mode — Playwright instance is managed by the daemon.
(sci-reload!)Reloads the current page (backend-aware).
Reloads the current page (backend-aware).
(sci-report->html entries)(sci-report->html entries opts)Builds a rich HTML report from typed entries. No page needed.
Builds a rich HTML report from typed entries. No page needed.
(sci-report->pdf entries)(sci-report->pdf entries opts)Renders a rich HTML report to PDF via Playwright's page.pdf().
Renders a rich HTML report to PDF via Playwright's page.pdf().
(sci-resolve-ref ref-id)Resolves a snapshot ref (e.g. "@e2yrjz") to a Playwright Locator.
Resolves a snapshot ref (e.g. "@e2yrjz") to a Playwright Locator.
(sci-restart!)(sci-restart! opts)Stops the current session and starts a new one with the given options.
Stops the current session and starts a new one with the given options.
(sci-route! pattern handler)(sci-route-from-har! har)(sci-route-from-har! har opts)(sci-route-web-socket! pattern handler)(sci-routes)(sci-routes opts)Extracts all links from the page. Returns map with :url :count :links.
Extracts all links from the page. Returns map with :url :count :links.
(sci-run-with-webview-context opts callback)Runs a deferred body in an inspectable iOS WebView and restores the exact prior context. Options accept :timeout-ms and an exact :context name.
Runs a deferred body in an inspectable iOS WebView and restores the exact prior context. Options accept :timeout-ms and an exact :context name.
(sci-save-annotated-screenshot! refs path)(sci-save-annotated-screenshot! refs path opts)(sci-save-audit-screenshot! caption path)(sci-save-audit-screenshot! caption path opts)Takes an audit screenshot and saves it to a file.
Takes an audit screenshot and saves it to a file.
(sci-screenshot)(sci-screenshot path-or-opts)(sci-scroll)(sci-scroll direction)(sci-scroll direction opts)Scrolls the page or a specific element. direction - :up :down :left :right (default :down) opts map keys: :amount - pixels to scroll (default 500) :smooth? - true for smooth animated scroll (default false) :selector - element ref or CSS selector to scroll within
Scrolls the page or a specific element. direction - :up :down :left :right (default :down) opts map keys: :amount - pixels to scroll (default 500) :smooth? - true for smooth animated scroll (default false) :selector - element ref or CSS selector to scroll within
(sci-scroll-into-view sel)(sci-scroll-position)Returns the current scroll position of the page as {:x N :y N}.
Returns the current scroll position of the page as {:x N :y N}.
(sci-scrollable)Finds all scrollable elements on the current page. Returns a vector of maps with scroll metadata (tag, id, scroll dimensions, overflow).
Finds all scrollable elements on the current page. Returns a vector of maps with scroll metadata (tag, id, scroll dimensions, overflow).
(sci-search! query)(sci-search! query opts)(sci-search-and-collect! query)(sci-search-and-collect! query opts)(sci-search-go-to-page! query page-num)(sci-search-go-to-page! query page-num opts)(sci-search-next-page!)(sci-search-pages query)(sci-search-pages query opts)(sci-search-url query)(sci-search-url query opts)(sci-select sel values)(sci-session-idle-timeout)Returns the current session idle timeout in milliseconds.
The daemon auto-shuts down if no commands are received within this window. 0 means disabled. Default: 1800000 (30 min) — long enough to survive the thinking pauses of an agent workflow, which a 5-minute window did not. Set SPEL_SESSION_IDLE_TIMEOUT env var or call (spel/set-session-idle-timeout! ms).
Returns the current session idle timeout in milliseconds. The daemon auto-shuts down if no commands are received within this window. 0 means disabled. Default: 1800000 (30 min) — long enough to survive the thinking pauses of an agent workflow, which a 5-minute window did not. Set SPEL_SESSION_IDLE_TIMEOUT env var or call (spel/set-session-idle-timeout! ms).
(sci-set-assertion-timeout! ms)(sci-set-cdp-idle-timeout! ms)Sets the CDP idle timeout in milliseconds.
0 disables auto-shutdown. Takes effect on the next CDP disconnect.
Example: (spel/set-cdp-idle-timeout! 60000) ; 1 minute (spel/set-cdp-idle-timeout! 0) ; disable
Sets the CDP idle timeout in milliseconds. 0 disables auto-shutdown. Takes effect on the next CDP disconnect. Example: (spel/set-cdp-idle-timeout! 60000) ; 1 minute (spel/set-cdp-idle-timeout! 0) ; disable
(sci-set-cdp-lock-wait! s)Sets the CDP route lock wait timeout in seconds.
0 disables waiting (fail-fast). Takes effect on the next lock conflict.
Example: (spel/set-cdp-lock-wait! 60) ; wait up to 1 minute (spel/set-cdp-lock-wait! 0) ; fail immediately
Sets the CDP route lock wait timeout in seconds. 0 disables waiting (fail-fast). Takes effect on the next lock conflict. Example: (spel/set-cdp-lock-wait! 60) ; wait up to 1 minute (spel/set-cdp-lock-wait! 0) ; fail immediately
(sci-set-content! html)(sci-set-content! html opts)(sci-set-default-navigation-timeout! ms)(sci-set-device! device)Switch the current session to a device preset programmatically.
Unlike set-viewport-size!, this reproduces a full device:
viewport + device-scale-factor + mobile flag + touch + user agent.
Accepts:
:iphone-14, :pixel-7, :ipad-mini, etc."iPhone 14", "iphone-14", "iphone_14"
(matching is loose — case/separator/punctuation insensitive).Behavior in daemon mode: delegates to the daemon handler, which saves the current URL, closes the context, creates a fresh one with the preset options, and re-navigates. Console/error/response listeners are re-registered automatically.
Behavior in standalone SCI (no daemon): recreates the context on the existing browser and opens a new page.
Throws when the device name is unknown — the error carries the list of available presets.
Returns: {:device <name> :preset <preset-map>}.
Examples: (spel/set-device! :iphone-14) (spel/set-device! "Pixel 7") (spel/navigate "https://example.org") (spel/screenshot {:path "/tmp/mobile.png"})
Switch the current session to a device preset programmatically.
Unlike `set-viewport-size!`, this reproduces a full device:
viewport + device-scale-factor + mobile flag + touch + user agent.
Accepts:
- A keyword: `:iphone-14`, `:pixel-7`, `:ipad-mini`, etc.
- A string device name: `"iPhone 14"`, `"iphone-14"`, `"iphone_14"`
(matching is loose — case/separator/punctuation insensitive).
Behavior in daemon mode: delegates to the daemon handler, which saves
the current URL, closes the context, creates a fresh one with the
preset options, and re-navigates. Console/error/response listeners
are re-registered automatically.
Behavior in standalone SCI (no daemon): recreates the context on the
existing browser and opens a new page.
Throws when the device name is unknown — the error carries the list
of available presets.
Returns: `{:device <name> :preset <preset-map>}`.
Examples:
(spel/set-device! :iphone-14)
(spel/set-device! "Pixel 7")
(spel/navigate "https://example.org")
(spel/screenshot {:path "/tmp/mobile.png"})(sci-set-extra-http-headers! headers)(sci-set-input-files! sel files)(sci-set-page-default-timeout! ms)(sci-set-session-idle-timeout! ms)Sets the session idle timeout in milliseconds.
0 disables auto-shutdown. Takes effect immediately (resets the timer).
Example: (spel/set-session-idle-timeout! 1800000) ; 30 minutes (the default) (spel/set-session-idle-timeout! 0) ; disable
Sets the session idle timeout in milliseconds. 0 disables auto-shutdown. Takes effect immediately (resets the timer). Example: (spel/set-session-idle-timeout! 1800000) ; 30 minutes (the default) (spel/set-session-idle-timeout! 0) ; disable
(sci-set-viewport-size! width height)(sci-sleep ms)(sci-smooth-scroll y-or-opts)Smooth-scrolls the page to the given Y position (or by a delta). Uses CSS smooth scroll behavior for natural-looking video recordings.
Usage: (spel/smooth-scroll 500) ;; scroll to Y=500 (spel/smooth-scroll {:top 500}) ;; same (spel/smooth-scroll {:delta-y 300}) ;; scroll down by 300px
Smooth-scrolls the page to the given Y position (or by a delta).
Uses CSS smooth scroll behavior for natural-looking video recordings.
Usage:
(spel/smooth-scroll 500) ;; scroll to Y=500
(spel/smooth-scroll {:top 500}) ;; same
(spel/smooth-scroll {:delta-y 300}) ;; scroll down by 300px(sci-smooth-scroll-by delta-y)Smoothly scrolls the page by a relative delta (positive=down, negative=up). Waits for the scroll animation to complete.
Smoothly scrolls the page by a relative delta (positive=down, negative=up). Waits for the scroll animation to complete.
(sci-smooth-scroll-to y)Smoothly scrolls the page to an absolute Y position. Waits for the scroll animation to complete.
Smoothly scrolls the page to an absolute Y position. Waits for the scroll animation to complete.
(sci-snapshot)(sci-snapshot page-or-opts)(sci-snapshot page opts)(sci-source query)Shows the source code of a SCI eval function. Accepts 'ns/fn' format (e.g. 'spel/click') or bare function name to search.
Shows the source code of a SCI eval function. Accepts 'ns/fn' format (e.g. 'spel/click') or bare function name to search.
(sci-start!)(sci-start! opts)(sci-start-video-recording)(sci-start-video-recording opts)Starts video recording by creating a new context with video recording enabled. Closes the current context/page and creates new ones with video.
Opts: :video-dir - String. Directory for video files (default: "videos"). :video-size - Map with :width :height (default: 1280x720).
Starts video recording by creating a new context with video recording enabled. Closes the current context/page and creates new ones with video. Opts: :video-dir - String. Directory for video files (default: "videos"). :video-size - Map with :width :height (default: 1280x720).
(sci-stop!)Stops the active session (Playwright or iOS backend), closing the browser and cleaning up resources.
Stops the active session (Playwright or iOS backend), closing the browser and cleaning up resources.
(sci-survey)(sci-survey opts)Scrolls through the page taking a screenshot at each viewport position. Returns vector of {:path :y :index :viewport} maps.
Scrolls through the page taking a screenshot at each viewport position.
Returns vector of {:path :y :index :viewport} maps.(sci-swipe direction-or-opts)(sci-swipe direction-or-opts distance)Performs a native touch swipe (iOS backend only).
Forms: (spel/swipe :up) ;; default distance 300 (spel/swipe :up 500) (spel/swipe {:from [200 600] :to [200 100] :duration 800})
Performs a native touch swipe (iOS backend only).
Forms:
(spel/swipe :up) ;; default distance 300
(spel/swipe :up 500)
(spel/swipe {:from [200 600] :to [200 100] :duration 800})(sci-switch-tab! idx)Switches to the tab at the given index.
Switches to the tab at the given index.
(sci-tabs)Returns a list of all open tabs with their index, url, title, and active status.
Returns a list of all open tabs with their index, url, title, and active status.
(sci-tap sel)Taps an element. On the iOS backend this is a native touch pointer action; on Playwright it delegates to locator tap emulation. Also accepts [x y] coordinates on the iOS backend.
Taps an element. On the iOS backend this is a native touch pointer action; on Playwright it delegates to locator tap emulation. Also accepts [x y] coordinates on the iOS backend.
(sci-text sel)(sci-thread-sleep ms)Plain JVM thread sleep (ms). Does NOT interact with browser event loop. Prefer page waits (wait-for-selector, wait-for-url, etc.) for browser sync. Use only for non-browser delays (file I/O timing, external process waits).
Plain JVM thread sleep (ms). Does NOT interact with browser event loop. Prefer page waits (wait-for-selector, wait-for-url, etc.) for browser sync. Use only for non-browser delays (file I/O timing, external process waits).
(sci-title)Returns the current page title (backend-aware).
Returns the current page title (backend-aware).
(sci-touchscreen)(sci-trace-group name)Opens a named group in the trace. Groups nest actions visually in Trace Viewer.
Opens a named group in the trace. Groups nest actions visually in Trace Viewer.
(sci-trace-group-end)Closes the current trace group.
Closes the current trace group.
(sci-trace-start!)(sci-trace-start! opts)Starts Playwright tracing on the current context.
Opts: :name - String. Trace name (appears in Trace Viewer). :screenshots - Boolean. Capture screenshots (default: false). :snapshots - Boolean. Capture DOM snapshots (default: false). :sources - Boolean. Include source files (default: false).
Starts Playwright tracing on the current context. Opts: :name - String. Trace name (appears in Trace Viewer). :screenshots - Boolean. Capture screenshots (default: false). :snapshots - Boolean. Capture DOM snapshots (default: false). :sources - Boolean. Include source files (default: false).
(sci-trace-stop!)(sci-trace-stop! opts)Stops Playwright tracing and saves to a file.
Opts: :path - String. Output path (default: "trace.zip").
Stops Playwright tracing and saves to a file. Opts: :path - String. Output path (default: "trace.zip").
(sci-type-text sel text)(sci-type-text sel text opts)(sci-unannotate)Removes all annotation overlays from the current page.
Removes all annotation overlays from the current page.
(sci-uncheck sel)(sci-uncheck sel opts)(sci-unmark)Removes all pre-action markers from the current page.
Removes all pre-action markers from the current page.
(sci-unroute! pattern)(sci-url)Returns the current URL (backend-aware).
Returns the current URL (backend-aware).
(sci-url-decode s)Decodes URL-encoded text using UTF-8.
Delegates to core/url-decode.
Decodes URL-encoded text using UTF-8. Delegates to core/url-decode.
(sci-url-encode s)Encodes text for use in URL query strings using UTF-8.
Delegates to core/url-encode.
Encodes text for use in URL query strings using UTF-8. Delegates to core/url-encode.
(sci-value sel)(sci-video-path)Returns the video file path for the current page, or nil if not recording.
Returns the video file path for the current page, or nil if not recording.
(sci-viewport-size)Returns the current viewport size of the active page as {:width N :height N}.
Returns the current viewport size of the active page as {:width N :height N}.
(sci-visible? sel)(sci-wait-for sel)(sci-wait-for sel opts)(sci-wait-for-download action)(sci-wait-for-download action opts)(sci-wait-for-file-chooser action)(sci-wait-for-file-chooser action opts)(sci-wait-for-function expr)(sci-wait-for-function expr opts)(sci-wait-for-load)(sci-wait-for-load state)(sci-wait-for-popup action)(sci-wait-for-popup action opts)(sci-wait-for-url url)(sci-wait-for-url url opts)(sci-with-webview-context-macro _form _env first-form & remaining-forms)Defers body until an inspectable iOS WebView is active and restores the exact prior context. Restoration occurs after success or failure.
Defers body until an inspectable iOS WebView is active and restores the exact prior context. Restoration occurs after success or failure.
(sci-wsl-default-gateway-ip)Returns the Windows host IP from /proc/net/route when inside WSL, nil otherwise. Under classic NAT networking this is the IP spel uses to reach a Windows-side Chrome via CDP.
Returns the Windows host IP from /proc/net/route when inside WSL, nil otherwise. Under classic NAT networking this is the IP spel uses to reach a Windows-side Chrome via CDP.
(sci-wsl?)Returns true when running inside Windows Subsystem for Linux. Detects via /proc/version markers and WSL_DISTRO_NAME env var.
Returns true when running inside Windows Subsystem for Linux. Detects via /proc/version markers and WSL_DISTRO_NAME env var.
(set-default-timeout! ms)Sets the default Playwright action timeout (ms) for new pages. Called from eval-sci mode when --timeout flag is provided.
Sets the default Playwright action timeout (ms) for new pages. Called from eval-sci mode when --timeout flag is provided.
(set-throw-on-error! v)When true, Playwright operations throw on error instead of returning anomaly maps. Called from eval-sci mode so errors short-circuit (do ...) forms.
When true, Playwright operations throw on error instead of returning anomaly maps. Called from eval-sci mode so errors short-circuit (do ...) forms.
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 |