Check a UI predicate on a selector
isChecks whether a UI selector currently matches a predicate like visible, hidden, exists, absent, or checked without polling. Use it to verify element state on a device before acting.
Instructions
Check whether a selector satisfies a UI predicate such as visible, hidden, exists, absent, editable, selected, checked, focused, or text. absent passes only when one readable, complete, settled, unscoped, full-depth accessibility capture has zero matches. This command checks the current condition without polling. Times out after 90s.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"predicate": "<predicate>",
"selector": "<selector>"
},
"name": "is"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| raw | No | Use raw snapshot data during selector resolution. | |
| udid | No | Apple device or simulator UDID. | |
| depth | No | Snapshot traversal depth. | |
| scope | No | Snapshot scope selector used before resolution. | |
| value | No | ||
| device | No | Device name; ids go in udid or serial. | |
| record | No | Force-record this out-of-band observation into a repair-armed heal (mutually exclusive with noRecord). Authored replay steps are recorded automatically and never need this. On find, valid only for a read-only action. | |
| serial | No | Android, HarmonyOS, or Vega VVD serial. | |
| session | No | Session name. | |
| noRecord | No | Do not record this action. | |
| platform | No | Device platform. | |
| selector | Yes | ||
| predicate | Yes | ||
| deviceTarget | No | Device form factor. |