Antibot

Performs an accessibility action on a node identified by AXNodeId.
Retries automatically (up to 10 times at 200ms intervals) for OOPIFs
where the browser-side AX tree may take time to populate.

Parameters

Return Object

Searches the browser-side AX tree across ALL frames (including OOPIFs)
for a node matching the selector, then performs the specified action.
Only "role" and "axNodeId" selector types are supported.
For "role" type, query is the AX role (e.g. "checkbox", "button")
and the browser walks all frames' AX trees. This works for OOPIF
frames where CDP Accessibility.getFullAXTree cannot reach
cross-process nodes.
Retries up to 40 times at 300ms intervals (~12s) if no match found.

Parameters

Return Object

Moves mouse to target with human-like Bezier curve trajectory.
Includes natural jitter and distortion to mimic hand tremor.
For non-steady moves greater than 50px, there is a 30% chance of
overshooting by 3-12px then correcting back.
Supports all selector types except bottom.

Parameters

Return Object

Moves to target then clicks with human-like timing.
Supports all selector types except bottom.

Parameters

Return Object

Drag from source to destination with human-like Bezier movement.
Supports all selector types except bottom.

Parameters

Return Object

Moves to target element, presses mouse down, holds for a minimum time,
then releases. Used for captcha puzzles requiring long-press interactions.
Supports all selector types except bottom.

Parameters

Return Object

Moves to target element, presses mouse down, slides the mouse
to a target position, then releases.
Used for slider captcha puzzles.
Supports all selector types except bottom.

Two modes:
1. Fixed distance: provide "distance" in CSS pixels.
2. Target selector: provide "target" selector — the command resolves
both source and target positions and computes the slide distance
automatically with slight human-like imprecision.
At least one of "distance" or "target" must be provided.

Parameters

Return Object

Human-like scroll. Three modes:

1. Element into view: provide selector (css/xpath/axNodeId/coord/role).
Scrolls until element is within 20% of viewport center, using wheel
events in 3-8 steps. Skips if already visible near center.

2. Scroll to bottom: provide selector {type:"bottom", query:""}.
Scrolls 0.5-0.9x viewport height per step, 3-8 wheel events with
50-150ms delays. If mouse is near origin, first moves it to a random
position with a Bezier curve. Returns atBottom=true when scrollY is
within 5px of the maximum scroll offset.

3. Manual delta: provide delta (no selector). Scrolls by the given pixel
offset using 3-8 wheel steps.

Supports all selector types including bottom.

Parameters

Return Object

Types text character by character with human WPM timing model.
Uses profile-aware keyboard mapping for correct key codes.
Timing: base_delay = 60 / (wpm * 5) seconds per keystroke, with
per-character random variation, common bigram speedup, space pauses,
and shift penalty for uppercase characters.

Parameters

Return Object

Clicks on element, optionally clears it, then types text with human timing.
Supports all selector types except bottom.

Parameters

Return Object

Injects a debug cursor overlay (red dot + trail) for visual testing.
Persists across navigations — re-injected automatically on page load.

Parameters

Return Object

Highlights a target element on the debug cursor overlay: four corner
brackets painted around the element's bounding box in a kind-specific
color, auto-expiring after ttlMs. Use to signal what the agent is
ABOUT to interact with (focus paint before dispatch) so an operator
replaying the screencast can see intent, not just outcome.

No-op when showCursor hasn't been called for this session — the
paint pipeline only runs while the cursor overlay is enabled.

Bounds resolution is the same Mojo path QuerySelectorBounds uses
(no JS execution, no DOM mutation). Out-of-viewport or hidden
elements still receive a paint when their layout box is non-empty —
the corner brackets may sit off-screen in that case, which is the
truthful representation of where the element is.

Selector types: same set as moveTo (css / xpath / axNodeId / coord
/ backendNodeId). For backendNodeId, the query is the integer
BackendNodeId as a decimal string.

Parameters

Return Object

Paints a "going there next" preview line on the cursor overlay: a
thin semi-transparent straight segment from the current tracked
cursor position to the target element's center. Use just before
firing a click/move to telegraph intent — the operator sees WHERE
the cursor is about to travel before any motion begins.

The straight line is intentional: it represents intent, not the
actual Bezier trajectory the human-input model will draw (which
is randomized per-call and shouldn't be teased before it runs).

No-op when showCursor isn't enabled. Fire-and-forget — agents call
this in parallel with the real click/move dispatch and never await
the response.

Parameters

Return Object

Returns all frames including OOPIFs with their metadata.
Uses ForEachRenderFrameHost to enumerate every frame in the page,
including cross-origin out-of-process iframes.

Return Object

Locates an element in a specific frame and returns its bounding box
in main-frame viewport coordinates (CSS pixels). This allows clicking
on elements inside OOPIFs with correct screen-space coordinates.
Only "css", "xpath", and "axNodeId" selector types are supported.

Parameters

Return Object

Locates an element across ALL frames (main + iframes/OOPIFs).
Tries main frame first, then walks child frames until found.
Returns bounding box in main-frame CSS viewport coordinates.
Supports css, xpath, axNodeId, coord, and role selector types (not bottom).

Parameters

Return Object

Waits for a selector to appear in any frame (main + iframes/OOPIFs).
Polls natively via Mojo every 200ms (no JS execution). Searches main
frame first, then child frames on each poll cycle.
Supports css, xpath, axNodeId, coord, and role selector types (not bottom).

Parameters

Return Object

Returns the current tracked mouse position in CSS viewport pixels.

Return Object

Checks whether an element is visible in the viewport.
Only "css" and "xpath" selector types are supported.
Searches main frame first, then child frames (iframes/OOPIFs).
Visibility is determined by the renderer (checks display, opacity,
dimensions, and viewport intersection).

Parameters

Return Object

Checks whether the currently focused element matches the selector.
Only "css" and "xpath" selector types are supported. Searches the
main frame first, then iframes/OOPIFs — focus may be inside an OOPIF.
Useful as a pre-flight check before sending keystrokes blindly to
the focused element: e.g. PasswordManager.prefillChoice uses this
to confirm the password field is still focused before typing.

Parameters

Return Object

Sends a single key press with human-like timing (keyDown + keyUp,
30-70ms hold duration).

Special key names (case-insensitive):
"Enter", "Tab", "Escape" (or "Esc"), "Backspace", "Delete",
"Space", "Home", "End", "PageUp", "PageDown",
"ArrowUp" (or "Up"), "ArrowDown" (or "Down"),
"ArrowLeft" (or "Left"), "ArrowRight" (or "Right")

Single characters: any single character (e.g. "a", "A", "1", "@").
Shift is applied automatically when the character requires it.

Modifier combos: prefix with "Ctrl+", "Shift+", "Alt+", or "Meta+"
(case-insensitive). One modifier prefix per call.
Examples: "Ctrl+a", "Ctrl+c", "Ctrl+v", "Shift+Tab", "Alt+F4"

Parameters

Return Object

Moves mouse to element with human-like trajectory and pauses
briefly to trigger hover states (CSS :hover, tooltips, menus).
Supports all selector types except bottom.

Parameters

Return Object

Selects an option in a <select> or custom dropdown.
Only "css" and "xpath" selector types are supported.

For native <select>: clicks the element, then selects the option
via the browser's native popup. Fires change/input events.

For custom dropdowns (Bootstrap, React Select, MUI, etc.): provide
optionSelector — the command will click the trigger to open the dropdown,
find the matching option element, and click it.

Matching: provide exactly one of value, text, or index.
For native <select>:
- "value" matches the <option> value attribute
- "text" matches the <option> text content (whitespace-stripped)
- "index" matches by 0-based position
For custom dropdowns with optionSelector:
- "text" matches against option element's textContent
- "index" matches by 0-based position among matched elements
- If optionSelector already includes an attribute filter
(e.g. ".dropdown-item[data-value='US']"), the first match is clicked

Parameters

Return Object

Enables automatic captcha detection AND solving. While enabled, the
browser scans the frame tree after each navigation, emits
captchaDetected for recognized challenges, and then immediately drives
the solve (slider / checkbox interaction, or remote solver for token types)
serialized one-at-a-time. Clients observe progress via the
captchaSolvingStarted / captchaSolved / captchaError events. No-op
if already enabled. Disable with captchaDisable.

Disables captcha detection. The session history of detected captchas
(and their solve/error outcomes) is preserved — retrieve it with
getSolvedCaptchas. Events already in flight (from captchaEnable) may
still arrive.

Returns the full list of captchas seen this session, including ones
that failed and ones still pending. Preserved across captchaDisable
so billing / telemetry can retrieve it at shutdown.

Return Object

Requests the browser to solve a previously detected captcha.

Remote-solver credentials and the egress the solver dials are configured
browser-side, not through CDP — so they are never exposed on this
channel. Types that need the remote solver (turnstile token, datadome
token, recaptcha, geetest) fail with captchaError when it is not
configured.

For turnstile_checkbox and datadome_slider nothing is needed — the
browser solves these via the existing Antibot interaction primitives.

Parameters

Return Object

Disables the Antibot domain.

Emitted when the browser detects a captcha challenge on the page
(Turnstile widget, DataDome slider/interstitial, reCAPTCHA, GeeTest).
Once captchaEnable has been called, the browser autonomously solves
the challenge (interaction for slider/checkbox, remote solver delegation
for token types) and then emits captchaSolvingStarted / captchaSolved
(or captchaError on failure) — the client does not need to call
solveCaptcha. solveCaptcha remains available as an explicit escape
hatch for manual re-trigger.

Parameters

Emitted when the browser starts solving a captcha (either via direct
interaction or by dispatching a job to the remote solver). Useful for UI spinners
/ timing instrumentation on the client side.

Parameters

Emitted when a captcha is solved. For interaction-based solves
(slider, checkbox, managed, hold, coords) the token field is empty; for
token solves delegated to a remote solver it contains the response token.

Parameters

Emitted when a captcha cannot be solved (timeout, remote solver
unavailable, challenge not solvable, DOM element not found, etc.).

Parameters

How to locate an element. Not all commands support all types;
see each command's documentation for supported selector types.

Allowed Values

• css
• xpath
• axNodeId
• backendNodeId
• coord
• role
• bottom

Element selector — a type + query pair.
The query format depends on the type:
css — CSS selector, e.g. "#btn", "input[name='email']"
xpath — XPath expression, e.g. "//div[@id='main']"
axNodeId — integer AX node ID as string, e.g. "42"
coord — "x,y" comma-separated CSS viewport pixels, e.g. "450,600"
role — AX role name (case-insensitive), e.g. "checkbox", "button"
bottom — no query needed (pass ""). Only valid for scroll.
Not all commands support all selector types; see each command's docs.

Properties

A point in CSS viewport pixels.

Properties

A rectangle in CSS viewport pixels.

Properties

Frame metadata returned by getFrames.

Properties

--- Captcha detection & solving ---

Captcha challenge type surfaced by captchaDetected / captchaSolved /
captchaError events. New types are added over time.

Allowed Values

• turnstile_checkbox
• turnstile
• datadome_slider
• datadome
• recaptcha
• geetest
• hcaptcha_click
• perimeterx_hold
• aws_waf
• cs_captcha_rotation

Per-detection record returned by getSolvedCaptchas.

Properties