BrowserContext class

BrowserContexts provide a way to operate multiple independent browser sessions. When a browser is launched, it has a single BrowserContext used by default. The method Browser.newPage creates a page in the default browser context.

If a page opens another page, e.g. with a window.open call, the popup will belong to the parent page's browser context.

Puppeteer allows creation of "incognito" browser contexts with Browser.createIncognitoBrowserContext method. "Incognito" browser contexts don't write any browsing data to disk.

Constructors

BrowserContext(Connection? connection, Browser browser, BrowserContextID? id)

Properties

browser → Browser

The browser this browser context belongs to.

final

connection → Connection?

final

hashCode → int

The hash code for this object.

no setter, inherited

id → BrowserContextID?

final

isIncognito → bool

Returns whether BrowserContext is incognito. The default browser context is the only non-incognito browser context.

no setter

onTargetChanged → Stream<Target>

Emitted when the url of a target inside the browser context changes.

no setter

onTargetCreated → Stream<Target>

Emitted when a new target is created inside the browser context, for example when a new page is opened by window.open or browserContext.newPage.

no setter

onTargetDestroyed → Stream<Target>

Emitted when a target inside the browser context is destroyed, for example when a page is closed.

no setter

pages → Future<List<Page>>

An array of all pages inside the browser context.

no setter

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

targets → List<Target>

An array of all active targets inside the browser context.

no setter

Methods

clearPermissionOverrides() → Future<void>

Clears all permission overrides for the browser context.

close() → Future<void>

Closes the browser context. All the targets that belong to the browser context will be closed.

newPage() → Future<Page>

Creates a new page in the browser context.

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

overridePermissions(String origin, List<PermissionType> permissions) → Future<void>

origin

toString() → String

A string representation of this object.

inherited

waitForTarget(bool predicate(Target), {Duration? timeout}) → Future<Target>

This searches for a target in this specific browser context.

Operators

operator ==(Object other) → bool

The equality operator.

inherited