Browse the docs

GET /browser/status

Lists the connected browser extensions, what they are subscribed to, and the instant registrations the engine gave them.

Details #

browsers has one row per connected extension: browser (safari or chrome), version, profile, incognitoAllowed, userScripts (whether the browser can run JS you wrote) and transport. subscriptions is the URL patterns and event kinds some enabled macro listens for; the extension reports only those. registrations is what each browser applies to a page by itself at document_start, with no round trip.

{ "browsers": [{ "browser": "chrome", "version": "155", "userScripts": true, "transport": "host" }],
  "subscriptions": { "urlPatterns": ["https://*.github.com/*"], "events": ["browser.page:loading"] },
  "registrations": [] }

With no extension connected the lists are empty.

Parameters #

curl --unix-socket "$SWITCHBOARD_HOME/engine.sock" -X GET http://localhost/browser/status

The connected browser extensions, what they subscribe to, and the instant registrations. The Unix socket needs no token; loopback 127.0.0.1:48080 needs Authorization: Bearer <api-token>.

See also #