BrowserContext 类

BrowserContext 代表 浏览器 中的独立用户上下文。

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

BrowserContext 发出 在 BrowserContextEvent 枚举中记录的各种事件。

如果 页面 打开另一个 页面，例如使用 window.open，则弹出窗口将属于父 页面的浏览器上下文。

签名

export declare abstract class BrowserContext extends EventEmitter<BrowserContextEvents>

继承自： EventEmitter<BrowserContextEvents>

备注

在 Chrome 中，所有非默认上下文都是隐身模式，如果启动浏览器时提供 --incognito 参数，则默认浏览器上下文可能是隐身模式。

此类的构造函数标记为内部函数。第三方代码不应直接调用构造函数或创建扩展 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	只读	boolean	此 浏览器上下文 是否已关闭。
id	只读	string | undefined	此 浏览器上下文 的标识符。

方法

方法	修饰符	描述
browser()		获取与此 浏览器上下文 关联的 浏览器。
clearPermissionOverrides()		清除此 浏览器上下文 的所有权限覆盖。
close()		关闭此 浏览器上下文 和所有关联的 页面。 备注 默认浏览器上下文 无法关闭。
cookies()		获取浏览器上下文中的所有 cookie。
deleteCookie(cookies)		删除浏览器上下文中的 cookie
newPage()		在此 浏览器上下文 中创建一个新的 页面。
overridePermissions(origin, permissions)		在给定的 origin 中授予此 浏览器上下文 给定的 permissions。
pages()		获取此 浏览器上下文 中所有打开的 页面 的列表。 备注 此处不会列出不可见的 页面，例如 "background_page"。您可以使用 Target.page() 找到它们。
setCookie(cookies)		在浏览器上下文中设置一个 cookie。
targets()		获取此 浏览器上下文 中所有活动的 目标。
waitForTarget(predicate, options)		等待出现与给定 predicate 匹配的 目标 并返回它。 这将查找所有打开的 浏览器上下文。