BrowserContext クラス

BrowserContext は、ブラウザ 内の個々のユーザーコンテキストを表します。

ブラウザ が起動されると、デフォルトで単一の ブラウザコンテキスト を持ちます。Browser.createBrowserContext() を使用して、他のコンテキストを作成できます。各コンテキストは、分離されたストレージ (クッキー/localStorage/など) を持ちます。

BrowserContext は、EventEmitter を BrowserContextEvent enum に記載されているさまざまなイベントを発生させます。

ページ が window.open などを使用して別の ページ を開くと、ポップアップは親のページのブラウザコンテキストに属します。

シグネチャ:

export declare abstract class BrowserContext extends EventEmitter<BrowserContextEvents>

拡張: EventEmitter<BrowserContextEvents>

備考

このクラスのコンストラクタは内部としてマークされています。サードパーティのコードは、コンストラクタを直接呼び出したり、BrowserContext クラスを拡張するサブクラスを作成したりしないでください。

例

新しいブラウザコンテキストを作成する

// Create a new browser context
const context = await browser.createBrowserContext();
// Create a new page inside context.
const page = await context.newPage();
// ... do stuff with page ...
await page.goto('https://example.com');
// Dispose context once it's no longer needed.
await context.close();

プロパティ

プロパティ	修飾子	型	説明
closed	readonly	boolean	このブラウザコンテキストが閉じているかどうか。
id	readonly	string | undefined	このブラウザコンテキストの識別子。

メソッド

メソッド	修飾子	説明
browser()		このブラウザコンテキストに関連付けられているブラウザを取得します。
clearPermissionOverrides()		このブラウザコンテキストのすべての権限のオーバーライドをクリアします。
close()		このブラウザコンテキストと関連付けられているすべてのページを閉じます。
isIncognito()		このブラウザコンテキストがインコグニートであるかどうか。 Chrome では、デフォルトのブラウザコンテキストのみが非インコグニートのブラウザコンテキストです。
newPage()		このブラウザコンテキストに新しいページを作成します。
overridePermissions(origin, permissions)		このブラウザコンテキストに、指定された origin 内で指定された permissions を許可します。
pages()		このブラウザコンテキスト内のすべての開いているページのリストを取得します。
targets()		このブラウザコンテキスト内のすべてのアクティブなターゲットを取得します。
waitForTarget(predicate, options)		指定された predicate に一致するターゲットが表示されるまで待機し、それを返します。 これは、すべての開いているブラウザコンテキストを検索します。