BrowserContext 类

BrowserContext 代表 浏览器 中的单个用户上下文。

当 浏览器 启动时，默认情况下它只有一个 浏览器上下文。可以使用 Browser.createBrowserContext() 创建其他上下文。每个上下文都有隔离的存储（cookie/localStorage/等）。

BrowserContext 发出 各种事件，这些事件在 BrowserContextEvent 枚举中进行了记录。

如果 页面 打开了另一个 页面，例如使用 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 匹配的 目标 出现并返回它。 这将查看所有打开的 浏览器上下文。