BrowserContext
BrowserContext
提供了一种操作多个独立会话的方式,每个会话拥有独立的页面、缓存和 cookies。浏览器启动时会创建一个默认的 BrowserContext
。
browser 模块 API 用于创建新的 BrowserContext
。
如果一个页面打开另一个页面,例如通过调用 window.open
,则该弹出窗口将属于父页面所在的 BrowserContext
。
方法 | 描述 |
---|---|
addCookies() | 将 cookies 添加到 BrowserContext 中。 |
addInitScript() | 添加一个脚本,该脚本将在页面创建、框架附加或导航发生时被评估执行。 |
clearCookies() | 清除 BrowserContext 的 cookies。 |
clearPermissions() | 清除 BrowserContext 的所有权限覆盖。 |
cookies() | 返回 BrowserContext 中的 cookies 列表。 |
close() | 关闭 BrowserContext 及其所有页面。 |
grantPermissions(permissions[, options]) | 授予 BrowserContext 指定的权限。 |
newPage() | 使用 BrowserContext 创建并返回一个新的页面。 |
pages() | 返回属于 BrowserContext 的页面列表。 |
setDefaultNavigationTimeout(timeout) | 设置默认的导航超时时间(毫秒)。 |
setDefaultTimeout(timeout) | 设置所有接受 timeout 选项的方法的默认最大超时时间(毫秒)。 |
setGeolocation(geolocation) | 设置 BrowserContext 的地理位置。 |
setOffline(offline) | 切换 BrowserContext 的连接状态(开/关)。 |
waitForEvent(event[, optionsOrPredicate]) | 等待事件触发并将其值传递给断言函数。 |