Skip to content

common_browser.context

An explicit context handle into the browser’s shared resource graph.

Classes

Context

One isolated or explicitly borrowed browser context.

__init__

def __init__(browser: BaseBrowser, reference: ContextRef) -> None

Fields and properties declared here; inherited members belong to the bases above.

pages

Read-only property.

pages: tuple[Page, ...]

reference

Read-only property.

reference: ContextRef

aclose

async def aclose() -> None

clear_cookies

async def clear_cookies(*, name: str | None = None, domain: str | None = None, path: str | None = None, options: OperationConfig | None = None) -> BrowserResult[None]

cookies

async def cookies(*, urls: tuple[str, ...] = (), options: OperationConfig | None = None) -> BrowserResult[tuple[Cookie, ...]]

export_state

async def export_state(*, indexed_db: bool = False, options: OperationConfig | None = None) -> BrowserResult[StorageSnapshot]

fetch

async def fetch(url: str, *, to: Path | str | None = None, max_bytes: int | None = None, options: OperationConfig | None = None) -> BrowserResult[ArtifactData]

GET using context cookies; general HTTP belongs in common-http.

native

def native() -> AbstractAsyncContextManager[Any]

Exclusive advanced SDK access; invalidates observed references on exit.

new_page

async def new_page() -> Page

select_page

def select_page(reference: PageRef) -> Page

sequence

def sequence(*, options: OperationConfig | None = None) -> AbstractAsyncContextManager[None]

Task-owned exclusive context scope; nested operations reuse admission.

set_cookies

async def set_cookies(cookies: tuple[Cookie, ...], *, options: OperationConfig | None = None) -> BrowserResult[None]

start_trace

async def start_trace(*, options: OperationConfig | None = None) -> BrowserResult[ArtifactData | None]

stop_trace

async def stop_trace(*, to: Path | str, options: OperationConfig | None = None) -> BrowserResult[ArtifactData | None]

watch

def watch(expectation: EventWait, *, page: PageRef | None = None) -> EventSubscription