visualAction
Trusted pointer using fresh single-use snapshot IMAGE pixel x/y, never OS coordinates. Unique requestId: 8..128 alphanumeric/underscore/hyphen. down held until up/end/expiry; drag to:{x,y} uses same image. No replay after unknown outcome; inspect/new capture. Tab/document/frames/scroll/viewport/DPR must match. Delivery is not application success.
API 2.3.3 · Published service contract ↗
Usage
Use the typed read or action tool permitted by the selected Pass documentation. Operation: visualAction. A target tabId is required.
Use sym_pass_docs for the chosen Pass. Only its live supported operations and current capabilityRevision are callable.
Operation arguments
| Field | Type | Required | Description |
|---|---|---|---|
| leaseId | string | ✓ | |
| snapshotId | string | ✓ | |
| requestId | string | ✓ | |
| action | string | ✓ | Values: ["hover","click","doubleClick","rightClick","down","up","drag"] |
| x | number | ✓ | |
| y | number | ✓ | |
| to | object | × | |
| modifiers | array | × | |
| workSessionId | string | × |
{
"type": "object",
"properties": {
"leaseId": {
"type": "string",
"maxLength": 36
},
"snapshotId": {
"type": "string",
"maxLength": 36
},
"requestId": {
"type": "string",
"maxLength": 128
},
"action": {
"type": "string",
"enum": [
"hover",
"click",
"doubleClick",
"rightClick",
"down",
"up",
"drag"
]
},
"x": {
"type": "number",
"minimum": 0,
"maximum": 8192
},
"y": {
"type": "number",
"minimum": 0,
"maximum": 8192
},
"to": {
"type": "object",
"properties": {
"x": {
"type": "number",
"minimum": 0,
"maximum": 8192
},
"y": {
"type": "number",
"minimum": 0,
"maximum": 8192
}
},
"required": [
"x",
"y"
],
"additionalProperties": false
},
"modifiers": {
"type": "array",
"items": {
"type": "string",
"enum": [
"Alt",
"Control",
"Meta",
"Shift"
]
},
"minItems": 0,
"maxItems": 4
},
"workSessionId": {
"type": "string",
"minLength": 1,
"maxLength": 128
}
},
"required": [
"leaseId",
"snapshotId",
"requestId",
"action",
"x",
"y"
],
"additionalProperties": false
}Output
Output is operation- and device-dependent. Read the selected Pass’s current documentation and inspect the returned envelope.