High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.
Eval
Run JavaScript in the current tab. This endpoint is disabled unless evaluation is explicitly enabled in config.
Enabling security.allowEvaluate is a documented, non-default, security-reducing configuration change. It allows arbitrary JavaScript execution in page context and should only be used on trusted systems with authentication and network exposure reviewed explicitly.
curl -X POST http://localhost:9867/evaluate \
-H "Content-Type: application/json" \
-d '{"expression":"document.title"}'
# CLI Alternative
pinchtab eval "document.title"
# Response (default is result value; use --json for full JSON)
Example Domain
CLI Flags
| Flag | Description |
|---|---|
--await-promise |
Resolve returned Promise before responding |
--json |
Full JSON response |
--tab |
Target specific tab |
Examples
pinchtab eval "document.title"
pinchtab eval "document.querySelectorAll('a').length"
pinchtab eval "fetch('/api/data').then(r => r.json())" --await-promise
pinchtab eval "document.title" --json # {"result":"Example Domain"}
API Body Fields
| Field | Description |
|---|---|
expression |
JavaScript to evaluate (required; 400 when empty) |
awaitPromise |
Resolve a returned Promise before responding |
tabId |
Target a specific tab |
Response: {"result": <value>}. A Promise returned without awaitPromise
yields {} plus a hint field naming the flag.
Errors: 403 evaluate_disabled when security.allowEvaluate is off;
500 evaluate_null_ref (with a hint) when the expression dereferences a
null element; 409 dialog_blocked while a JavaScript dialog is open.
MCP: pinchtab_eval takes expression (required), awaitPromise, tabId.
Notes
- Requires
security.allowEvaluate: true - Tab-scoped variant:
POST /tabs/{id}/evaluate /evaluateis intentionally not frame-scoped- Current
/framestate does not affectpinchtab eval - For iframe access, your expression must handle that explicitly