eval
Run a user-authorized JavaScript expression in this tab using the existing native page evaluator. Full/control Pass only; may read or change the authenticated page. Tracked MCP evaluation always awaits Promises; detached evaluation is a separate low-level CDP call, not this tracked operation. Async IIFEs are awaited; return a compact serializable value. Do not access credentials or broaden the user task. JS-generated input is not trusted input. navigates:true waits for navigation; timeoutMs bounds that wait, NOT arbitrary script execution. A timeout or lost response may leave effects applied: inspect, never automatically retry.
API 2.3.3 · Published service contract ↗
Usage
Use the typed read or action tool permitted by the selected Pass documentation. Operation: eval. 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 |
|---|---|---|---|
| expression | string | ✓ | |
| awaitPromise | boolean | × | Tracked MCP eval awaits completion; use the low-level tab CDP operation for explicit detached evaluation. Values: [true] |
| navigates | boolean | × | |
| timeoutMs | integer | × | |
| workSessionId | string | × |
{
"type": "object",
"properties": {
"expression": {
"type": "string",
"maxLength": 250000,
"minLength": 1
},
"awaitPromise": {
"type": "boolean",
"enum": [
true
],
"description": "Tracked MCP eval awaits completion; use the low-level tab CDP operation for explicit detached evaluation."
},
"navigates": {
"type": "boolean"
},
"timeoutMs": {
"type": "integer",
"minimum": 1,
"maximum": 15000
},
"workSessionId": {
"type": "string",
"minLength": 1,
"maxLength": 128
}
},
"required": [
"expression"
],
"additionalProperties": false
}Output
Output is operation- and device-dependent. Read the selected Pass’s current documentation and inspect the returned envelope.