Context

A BrowserContext is an isolated browser profile with its own cookies, cache, and storage. Each context is independent — like a separate incognito window.

Create a Context

ctx, err := b.NewContext()
if err != nil {
    log.Fatal(err)
}
defer ctx.Close()

Context Options

ctx, err := b.NewContext(
    bonk.WithProxy("http://proxy:8080"),
    bonk.WithProxyBypass("localhost,127.0.0.1"),
    bonk.WithViewport(1920, 1080),
    bonk.WithUserAgent("Custom UA"),
    bonk.WithLocale("en-US"),
    bonk.WithTimezone("America/New_York"),
    bonk.WithGeolocation(40.7128, -74.0060),
    bonk.WithState("./session.dat"),
)

Option	Description
`WithProxy(string)`	Proxy server URL
`WithProxyBypass(string)`	Comma-separated list of hosts to bypass proxy
`WithViewport(w, h int)`	Default viewport for new pages
`WithUserAgent(string)`	User agent override
`WithLocale(string)`	Browser locale (e.g. `"en-US"`)
`WithTimezone(string)`	Timezone override (e.g. `"America/New_York"`)
`WithGeolocation(lat, lon float64)`	Geolocation override
`WithState(string)`	Load saved cookies from file

Default Timeouts

Set context-wide default timeouts so you don't have to pass them on every call:

ctx.SetDefaultTimeout(10 * time.Second)           // wait/query operations
ctx.SetDefaultNavigationTimeout(30 * time.Second)  // navigate, reload, go back/forward

Resolution order: page-level override > context-level override > 30s default.

Pages can override the context default:

page.SetDefaultTimeout(5 * time.Second)
page.SetDefaultNavigationTimeout(15 * time.Second)

Permissions

Grant browser permissions (geolocation, notifications, camera, etc.) for the context:

err = ctx.GrantPermissions([]string{"geolocation", "notifications"})

// scope to a specific origin
err = ctx.GrantPermissions(
    []string{"geolocation"},
    bonk.PermissionOrigin("https://example.com"),
)

// reset all permission overrides
err = ctx.ClearPermissions()

Pages

page, err := ctx.NewPage()

pages := ctx.Pages() // all open pages

Cookies

cookies, err := ctx.Cookies()

err = ctx.SetCookies(bonk.Cookie{
    Name:   "session",
    Value:  "abc123",
    Domain: ".example.com",
    Path:   "/",
})

err = ctx.ClearCookies()

State Persistence

Save cookies to disk and restore them later:

// save
err = ctx.SaveState("./session.dat")

// restore in a new context
ctx2, err := b.NewContext(bonk.WithState("./session.dat"))

See Session Persistence for details.

Close

Closes all pages and disposes the browser context:

ctx.Close()