Robot Actions — Remote Device Control

Previous value: -"ISO date (YYYY-MM-DD) — end of the window, inclusive."New value: +"ISO date (YYYY-MM-DD, zero-padded) — end of the window, inclusive."

Added value: +"^\\d{4}-\\d{2}-\\d{2}$"

Previous value: -"ISO date (YYYY-MM-DD) — start of the window, inclusive."New value: +"ISO date (YYYY-MM-DD, zero-padded) — start of the window, inclusive."

Added value: +"^\\d{4}-\\d{2}-\\d{2}$"

Previous value: -"Max steps to return (default 200, which is also the ceiling)."New value: +"Max steps to return (default 200, which is also the ceiling). Returns the LAST n steps, not the first — a run that fell over did so at the end. On a long run that means the window can exclude the very failure `firstFailureIndex` points at, so use failuresOnly=true to land on it instead of raising this."

Added value: +{
+  "description": "Only runs on this device (exact udid match).",
+  "type": "string"
+}

Added value: +{
+  "description": "ISO date (YYYY-MM-DD, zero-padded) — latest run to include.",
+  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+  "type": "string"
+}

Previous value: -"Only runs that failed — reported failures and inferred ones alike."New value: +"Only runs that failed — reported failures AND inferred ones, matching the verdict this tool reports."

Previous value: -"Max runs to return (default 50, which is also the ceiling)."New value: +"Max runs per page (default 50, which is also the ceiling)."

Added value: +{
+  "description": "Skip this many matching runs — page through with `total` to know when to stop.",
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "description": "Only runs on this platform, e.g. \"android\", \"ios\", \"linux\".",
+  "type": "string"
+}

Added value: +{
+  "description": "Free text matched against session id, test name and suite. Use this for a pasted session id; the truncated form shown in the UI matches too.",
+  "type": "string"
+}

Added value: +{
+  "description": "ISO date (YYYY-MM-DD, zero-padded) — earliest run to include.",
+  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+  "type": "string"
+}

Added value: +{
+  "description": "Include installed packages with no launcher activity — providers, services, OEM stubs. Default false.",
+  "type": "boolean"
+}

Previous value: -"Only list user-installed apps, excludes system apps (default: true)"New value: +"Only user-installed apps, excluding preinstalled ones (default: false)"

Added value: +{
+  "description": "Include hidden system bundles — view services, XPC helpers, SpringBoard — and return the raw Info.plist dicts. Default false. Very large output.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "How to match `label`. Default \"contains\" — strict, and the only modes that act without interpretation. \"fuzzy\" tolerates typos and word-order drift, and is tried ONLY after strict finds nothing; it REFUSES when two candidates are too close rather than guessing between them (e.g. \"Sign\" vs Sign In / Sign Out), and reports which attribute it matched.",
+  "enum": [
+    "exact",
+    "contains",
+    "fuzzy"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Send even when no focused field is reported (default: false)",
+  "type": "boolean"
+}

Added value: +{
+  "description": "How to match `label`. Default \"contains\" — strict, and the only modes that act without interpretation. \"fuzzy\" tolerates typos and word-order drift, and is tried ONLY after strict finds nothing; it REFUSES when two candidates are too close rather than guessing between them (e.g. \"Sign\" vs Sign In / Sign Out), and reports which attribute it matched.",
+  "enum": [
+    "exact",
+    "contains",
+    "fuzzy"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Bypass the HTTP cache (CDP ignoreCache) — a from-network reload (default: false)",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Set to \"native\" to fail loudly when the device keyboard is unavailable, instead of silently falling back to setting .value (isTrusted:false). Use for fields that gate on real keystrokes. iOS only — Android has no native-keyboard path here.",
+  "enum": [
+    "native"
+  ],
+  "type": "string"
+}

Previous value: -"Response headers for mode \"mock\", as {headerName: value} — e.g. {\"content-type\": \"application/json\"}"New value: +"Response headers for mode \"mock\", as {headerName: value} — e.g. {\"content-type\": \"application/json\"}. On iOS a `charset` in content-type is NOT applied to the response: an HTML body with non-ASCII characters must declare it in the document (e.g. <meta charset=\"utf-8\">) or it will be decoded with the default encoding and render as mojibake."

Previous value: -"Response headers for mode \"mock\", as {headerName: value} — e.g. {\"content-type\": \"application/json\"}"New value: +"Response headers for mode \"mock\", as {headerName: value} — e.g. {\"content-type\": \"application/json\"}. On iOS a `charset` in content-type is NOT applied to the response: an HTML body with non-ASCII characters must declare it in the document (e.g. <meta charset=\"utf-8\">) or it will be decoded with the default encoding and render as mojibake."

Previous value: -"Response headers for mode \"mock\", as {headerName: value} — e.g. {\"content-type\": \"application/json\"}"New value: +"Response headers for mode \"mock\", as {headerName: value} — e.g. {\"content-type\": \"application/json\"}. On iOS a `charset` in content-type is NOT applied to the response: an HTML body with non-ASCII characters must declare it in the document (e.g. <meta charset=\"utf-8\">) or it will be decoded with the default encoding and render as mojibake."

Added value: +{
+  "description": "CSS selector to wait for BEFORE evaluating. Polls until it matches, then runs the expression. Errors if it never appears within waitTimeoutMs — it will not evaluate anyway and hand back a null that reads like a real answer",
+  "type": "string"
+}

Added value: +{
+  "description": "Settle delay applied just before evaluating (and AFTER waitForSelector matches, when both are given). Use for animations that have started but not finished. Maximum 10000 ms",
+  "maximum": 10000,
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "description": "How long waitForSelector may poll. Default 5000 ms, maximum 15000 ms",
+  "maximum": 15000,
+  "minimum": 0,
+  "type": "integer"
+}

Previous value: -"Checks to run; omit for all. \"TouchTargetSize\" = tap targets below the recommended minimum; \"DuplicateClickableBounds\" = several tappable elements on identical bounds; \"MissingClickAction\" = a button-class element exposing no click action; \"RedundantDescription\" = description restates type/state/action; \"ClassName\" = control reports an uninterpretable class."New value: +"Checks to run; omit for all. \"TouchTargetSize\" = tap targets below the recommended minimum; \"DuplicateClickableBounds\" = several tappable elements on identical bounds; \"MissingClickAction\" = a button-class element exposing no click action; \"SpeakableTextPresent\" = an actionable control with no text, content description or labelled descendant; \"RedundantDescription\" = description restates type/state/action; \"ClassName\" = control reports an uninterpretable class."

Previous value: -[
-  "TouchTargetSize",
-  "DuplicateClickableBounds",
-  "MissingClickAction",
-  "RedundantDescription",
-  "ClassName"
-]New value: +[
+  "TouchTargetSize",
+  "DuplicateClickableBounds",
+  "MissingClickAction",
+  "SpeakableTextPresent",
+  "RedundantDescription",
+  "ClassName"
+]

Previous value: -"Max runs to return (TestRail default 250)"New value: +"Max runs to return in this page (TestRail default 250)"

Added value: +{
+  "description": "Row offset for paging past the first page",
+  "minimum": 0,
+  "type": "integer"
+}

Previous value: -"CDP target id from ios_safari_list_pages — auto-picked when omitted"New value: +"CDP target id from ios_safari_list_pages. Omit it to use the page ios_safari_navigate last landed on (or, failing that, the first loaded page) — only pass it to target a DIFFERENT tab"

Previous value: -"CDP target id from ios_safari_list_pages — auto-picked when omitted"New value: +"CDP target id from ios_safari_list_pages. Omit it to use the page ios_safari_navigate last landed on (or, failing that, the first loaded page) — only pass it to target a DIFFERENT tab"

Previous value: -"CDP target id from ios_safari_list_pages — auto-picked when omitted"New value: +"CDP target id from ios_safari_list_pages. Omit it to use the page ios_safari_navigate last landed on (or, failing that, the first loaded page) — only pass it to target a DIFFERENT tab"

Previous value: -"CDP target id from ios_safari_list_pages — auto-picked when omitted"New value: +"CDP target id from ios_safari_list_pages. Omit it to use the page ios_safari_navigate last landed on (or, failing that, the first loaded page) — only pass it to target a DIFFERENT tab"

Previous value: -"CDP target id from ios_safari_list_pages — auto-picked when omitted"New value: +"CDP target id from ios_safari_list_pages. Omit it to use the page ios_safari_navigate last landed on (or, failing that, the first loaded page) — only pass it to target a DIFFERENT tab"

Previous value: -"CDP target id from ios_safari_list_pages — auto-picked when omitted"New value: +"CDP target id from ios_safari_list_pages. Omit it to use the page ios_safari_navigate last landed on (or, failing that, the first loaded page) — only pass it to target a DIFFERENT tab"

Previous value: -"CDP target id from ios_safari_list_pages — auto-picked when omitted"New value: +"CDP target id from ios_safari_list_pages. Omit it to use the page ios_safari_navigate last landed on (or, failing that, the first loaded page) — only pass it to target a DIFFERENT tab"

Previous value: -"Checks to run; omit for all. \"TouchTargetSize\" = tap targets below the recommended minimum; \"DuplicateClickableBounds\" = several tappable elements on identical bounds; \"RedundantDescription\" = description restates type/state/action; \"ClassName\" = control reports an uninterpretable class."New value: +"Checks to run; omit for all. \"TouchTargetSize\" = tap targets below the recommended minimum; \"DuplicateClickableBounds\" = several tappable elements on identical bounds; \"MissingClickAction\" = a button-class element exposing no click action; \"RedundantDescription\" = description restates type/state/action; \"ClassName\" = control reports an uninterpretable class."

Previous value: -[
-  "TouchTargetSize",
-  "DuplicateClickableBounds",
-  "RedundantDescription",
-  "ClassName"
-]New value: +[
+  "TouchTargetSize",
+  "DuplicateClickableBounds",
+  "MissingClickAction",
+  "RedundantDescription",
+  "ClassName"
+]

Added value: +{
+  "description": "Only with scroll:true. Maximum scrolls before stopping regardless (default 6, max 20).",
+  "maximum": 20,
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "Defaults false. When true, audit the screen, scroll down, and audit again — repeating until a pass reveals no new elements or maxScrollSteps is reached — then report the deduplicated union. This CHANGES THE SCREEN: it scrolls the app and does not scroll back, and on a lazily-loaded list it will trigger loading. Leave it off when the app must not be disturbed.",
+  "type": "boolean"
+}

Previous value: -"Ordered USB HID Keyboard/Keypad usage codes to send (numbers, e.g. [0x04] for \"a\")"New value: +"Ordered USB HID Keyboard/Keypad usage codes to press together (numbers, e.g. [0x04] for \"a\"). Empty list = release any keys left held."

Removed value: -1

Added value: +{
+  "description": "Skip the clickability checks and dispatch at the element center regardless (default: false). Use only when the checks are wrong about a target you know is clickable — it restores the old behaviour, where a click on a hidden or covered element reports success without doing anything. Needs a center to aim at, so it still fails on a display:none or zero-size element; it does apply to visibility:hidden, opacity:0, pointer-events:none, disabled, off-viewport, and covered targets.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "How the tap is delivered. You rarely need this — the default is the best path each platform has (a real device tap on iOS, a browser touch on Android). \"touch\" is what a finger produces and drives elements that listen for pointer events, which many component libraries bind. On Android a touch also produces mousedown/mouseup unless a handler cancels pointerdown or touchstart — and when one does, click is suppressed too, which is when \"mouse\" is the way through. \"mouse\" sends mouse events only, and on iOS it opts OUT of the device tap in favour of the browser-level path, which delivers only mouseup+click and is not trusted. The response reports which was used via `via`.",
+  "enum": [
+    "touch",
+    "mouse"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Element ref from a page-elements listing, e.g. \"e12\". Provide this or `selector`. A ref points straight at the element it was issued for, so it survives markup that shifted position, and it can address elements no CSS selector can reach from the top of the page.",
+  "type": "string"
+}

Previous value: -"CSS selector for the element to click"New value: +"CSS selector for the target element. Provide this or `ref`."

Added value: +{
+  "description": "Append a webpage_snapshot of the resulting page (actionable elements only) so you can see what the click changed without a second call (default: false)",
+  "type": "boolean"
+}

Added value: +{
+  "description": "How long to keep retrying while the element is not yet clickable (default: 5000, max: 30000)",
+  "maximum": 30000,
+  "minimum": 0,
+  "type": "integer"
+}

Previous value: -[
-  "udid",
-  "selector"
-]New value: +[
+  "udid"
+]

Added value: +{
+  "description": "Element ref from a page-elements listing, e.g. \"e12\". Provide this or `selector`. A ref points straight at the element it was issued for, so it survives markup that shifted position, and it can address elements no CSS selector can reach from the top of the page.",
+  "type": "string"
+}

Previous value: -"CSS selector for the element"New value: +"CSS selector for the target element. Provide this or `ref`."

Previous value: -[
-  "udid",
-  "selector",
-  "name"
-]New value: +[
+  "udid",
+  "name"
+]

Added value: +{
+  "description": "Element ref from a page-elements listing, e.g. \"e12\". Provide this or `selector`. A ref points straight at the element it was issued for, so it survives markup that shifted position, and it can address elements no CSS selector can reach from the top of the page.",
+  "type": "string"
+}

Previous value: -"CSS selector for the element to read"New value: +"CSS selector for the target element. Provide this or `ref`."

Previous value: -[
-  "udid",
-  "selector"
-]New value: +[
+  "udid"
+]

Added value: +{
+  "description": "Element ref from a page-elements listing, e.g. \"e12\". Provide this or `selector`. A ref points straight at the element it was issued for, so it survives markup that shifted position, and it can address elements no CSS selector can reach from the top of the page.",
+  "type": "string"
+}

Previous value: -"CSS selector for the element to hover"New value: +"CSS selector for the target element. Provide this or `ref`."

Previous value: -[
-  "udid",
-  "selector"
-]New value: +[
+  "udid"
+]

Added value: +{
+  "description": "Android only: capture just this element, named by a ref from a page-elements listing",
+  "type": "string"
+}

Added value: +{
+  "description": "Element ref from a page-elements listing, e.g. \"e12\". Provide this or `selector`. A ref points straight at the element it was issued for, so it survives markup that shifted position, and it can address elements no CSS selector can reach from the top of the page.",
+  "type": "string"
+}

Previous value: -"CSS selector for the element to scroll into view"New value: +"CSS selector for the target element. Provide this or `ref`."

Previous value: -[
-  "udid",
-  "selector"
-]New value: +[
+  "udid"
+]

Added value: +{
+  "description": "Element ref from a page-elements listing, e.g. \"e12\". Provide this or `selector`. A ref points straight at the element it was issued for, so it survives markup that shifted position, and it can address elements no CSS selector can reach from the top of the page.",
+  "type": "string"
+}

Previous value: -"CSS selector for the <select> element"New value: +"CSS selector for the target element. Provide this or `ref`."

Previous value: -[
-  "udid",
-  "selector"
-]New value: +[
+  "udid"
+]

Added value: +{
+  "description": "Element ref from a page-elements listing, e.g. \"e12\". Provide this or `selector`. A ref points straight at the element it was issued for, so it survives markup that shifted position, and it can address elements no CSS selector can reach from the top of the page.",
+  "type": "string"
+}

Previous value: -"CSS selector for the input/textarea element"New value: +"CSS selector for the target element. Provide this or `ref`."

Previous value: -[
-  "udid",
-  "selector",
-  "text"
-]New value: +[
+  "udid",
+  "text"
+]