browser_policy

Restrict where a tab (or every tab the agent opens from now on) may navigate and load from: allow lists domains that are permitted (everything else is blocked), block lists domains that are denied. Subdomains match. Non-http schemes always pass. Blocked navigations fail with ERR_BLOCKED_BY_CLIENT.

Parameters

enum

required

One of: set, clear, status.

integer

Target tab id from browser_tabs, which lists tabs across all windows. Defaults to the agent’s most recently opened usable tab, or the only usable tab. Otherwise select a listed tabId.

string[]

boolean

set/clear: also make this the policy for tabs the agent opens later

Example

Allow-list for one tab

{
  "action": "set",
  "tabId": 1234,
  "allow": [
    "example.com",
    "cdn.example.net"
  ]
}

Block trackers on every tab the agent opens from now on

{
  "action": "set",
  "default": true,
  "block": [
    "doubleclick.net",
    "google-analytics.com"
  ]
}

Browser automation

Developer tools

Parameters

Example

​Parameters

​Example

Parameters

Example