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.

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

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.

The remote solver API key is read from the bot profile via
variables.captchaSolverApiKey (not passed through CDP). Types that require
the remote solver (turnstile token, datadome token, recaptcha, geetest) will
fail with captchaError if the key is missing.

The upstream proxy used by the remote solver is read from the bot profile via
variables.captchaProxy (http://user:pass@host:port). Chromium itself
egresses via a local soxy SOCKS5 proxy, but the remote solver needs direct
HTTP-proxy access to the same upstream egress for IP-bound solves.
Not passed through CDP to avoid leaking upstream creds on the wire.

For turnstile_checkbox and datadome_slider no key 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) 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, missing API key,
remote solver API error, 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
• 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
• perimeterx_hold
• aws_waf

Per-detection record returned by getSolvedCaptchas.

Properties