BrowserContext
BrowserContexts 提供了操作多个独立浏览器会话的方式。
如果一个页面打开另一个页面,例如使用 window.open
调用,弹出的页面将属于父页面的浏览器上下文。
Playwright 允许使用 browser.new_context() 方法创建隔离的非持久性浏览器上下文。非持久性浏览器上下文不会将任何浏览数据写入磁盘。
- 同步
- 异步
# create a new incognito browser context
context = browser.new_context()
# create a new page inside context.
page = context.new_page()
page.goto("https://example.com")
# dispose context once it is no longer needed.
context.close()
# create a new incognito browser context
context = await browser.new_context()
# create a new page inside context.
page = await context.new_page()
await page.goto("https://example.com")
# dispose context once it is no longer needed.
await context.close()
方法
add_cookies
添加于 v1.9 之前将 cookie 添加到此浏览器上下文。此上下文中的所有页面都将安装这些 cookie。可以通过 browser_context.cookies() 获取 cookie。
用法
- 同步
- 异步
browser_context.add_cookies([cookie_object1, cookie_object2])
await browser_context.add_cookies([cookie_object1, cookie_object2])
参数
cookies
List[Dict]#-
name
str -
value
str -
url
str (可选)url 或 domain / path 是必需的。可选。
-
domain
str (可选)要使 cookie 也适用于所有子域,请在域前加上一个点,例如:".example.com"。url 或 domain / path 是必需的。可选。
-
path
str (可选)url 或 domain / path 是必需的。可选。
-
expires
float (可选)Unix 时间(秒)。可选。
-
httpOnly
bool (可选)可选。
-
secure
bool (可选)可选。
-
sameSite
"Strict" | "Lax" | "None" (可选)可选。
-
返回
add_init_script
添加于 v1.9 之前添加一个将在以下场景之一中评估的脚本
- 在浏览器上下文中创建页面或进行导航时。
- 在浏览器上下文中任何页面中附加或导航子 frame 时。在这种情况下,脚本将在新附加的 frame 的上下文中评估。
脚本在文档创建后但在其任何脚本运行之前进行评估。这对于修改 JavaScript 环境很有用,例如为 Math.random
设置种子。
用法
在页面加载之前覆盖 Math.random
的示例
// preload.js
Math.random = () => 42;
- 同步
- 异步
# in your playwright script, assuming the preload.js file is in same directory.
browser_context.add_init_script(path="preload.js")
# in your playwright script, assuming the preload.js file is in same directory.
await browser_context.add_init_script(path="preload.js")
通过 browser_context.add_init_script() 和 page.add_init_script() 安装的多个脚本的评估顺序未定义。
参数
-
path
Union[str, pathlib.Path] (可选)#JavaScript 文件路径。如果 path 是相对路径,则它是相对于当前工作目录解析的。可选。
-
要在浏览器上下文中所有页面中评估的脚本。可选。
返回
clear_cookies
添加于 v1.9 之前从上下文移除 cookie。接受可选过滤器。
用法
- 同步
- 异步
context.clear_cookies()
context.clear_cookies(name="session-id")
context.clear_cookies(domain="my-origin.com")
context.clear_cookies(path="/api/v1")
context.clear_cookies(name="session-id", domain="my-origin.com")
await context.clear_cookies()
await context.clear_cookies(name="session-id")
await context.clear_cookies(domain="my-origin.com")
await context.clear_cookies(path="/api/v1")
await context.clear_cookies(name="session-id", domain="my-origin.com")
参数
-
domain
str | Pattern (可选)添加于: v1.43#仅移除具有给定域的 cookie。
-
name
str | Pattern (可选)添加于: v1.43#仅移除具有给定名称的 cookie。
-
path
str | Pattern (可选)添加于: v1.43#仅移除具有给定路径的 cookie。
返回
clear_permissions
添加于 v1.9 之前清除浏览器上下文的所有权限覆盖。
用法
- 同步
- 异步
context = browser.new_context()
context.grant_permissions(["clipboard-read"])
# do stuff ..
context.clear_permissions()
context = await browser.new_context()
await context.grant_permissions(["clipboard-read"])
# do stuff ..
context.clear_permissions()
返回
close
添加于 v1.9 之前关闭浏览器上下文。所有属于此浏览器上下文的页面都将被关闭。
默认浏览器上下文不能关闭。
用法
browser_context.close()
browser_context.close(**kwargs)
参数
返回
cookies
添加于 v1.9 之前如果未指定 URL,此方法将返回所有 cookie。如果指定了 URL,则仅返回影响这些 URL 的 cookie。
用法
browser_context.cookies()
browser_context.cookies(**kwargs)
参数
返回
expect_console_message
添加于: v1.34执行操作并等待上下文中的页面记录 ConsoleMessage。如果提供了 predicate,则将 ConsoleMessage 值传递给 predicate
函数,并等待 predicate(message)
返回真值。如果在 browser_context.on("console") 事件触发之前页面关闭,则会抛出错误。
用法
browser_context.expect_console_message()
browser_context.expect_console_message(**kwargs)
参数
-
predicate
Callable[ConsoleMessage]:bool (可选)#接收 ConsoleMessage 对象,并在等待应解决时解析为真值。
-
最大等待时间(毫秒)。默认为
30000
(30 秒)。传递0
禁用超时。默认值可以通过使用 browser_context.set_default_timeout() 更改。
返回
expect_event
添加于 v1.9 之前等待事件触发并将其值传递给 predicate 函数。当 predicate 返回真值时返回。如果在事件触发之前上下文关闭,则会抛出错误。返回事件数据值。
用法
- 同步
- 异步
with context.expect_event("page") as event_info:
page.get_by_role("button").click()
page = event_info.value
async with context.expect_event("page") as event_info:
await page.get_by_role("button").click()
page = await event_info.value
参数
-
事件名称,与传递给
browserContext.on(event)
的名称相同。 -
接收事件数据,并在等待应解决时解析为真值。
-
最大等待时间(毫秒)。默认为
30000
(30 秒)。传递0
禁用超时。默认值可以通过使用 browser_context.set_default_timeout() 更改。
返回
expect_page
添加于: v1.9执行操作并等待在上下文中创建新的 Page。如果提供了 predicate,则将 Page 值传递给 predicate 函数,并等待 predicate(event)
返回真值。如果在创建新的 Page 之前上下文关闭,则会抛出错误。
用法
browser_context.expect_page()
browser_context.expect_page(**kwargs)
参数
-
predicate
Callable[Page]:bool (可选)#接收 Page 对象,并在等待应解决时解析为真值。
-
最大等待时间(毫秒)。默认为
30000
(30 秒)。传递0
禁用超时。默认值可以通过使用 browser_context.set_default_timeout() 更改。
返回
expose_binding
添加于 v1.9 之前此方法会在上下文中每个页面的每个 frame 的 window
对象上添加一个名为 name 的函数。调用该函数时,它会执行 callback 并返回一个 Promise,该 Promise 解析为 callback 的返回值。如果 callback 返回一个 Promise,则会等待其完成。
callback 函数的第一个参数包含关于调用者的信息:{ browserContext: BrowserContext, page: Page, frame: Frame }
。
请参阅 page.expose_binding() 获取仅页面版本。
用法
将页面 URL 暴露给上下文中所有页面的所有 frame 的示例
- 同步
- 异步
from playwright.sync_api import sync_playwright, Playwright
def run(playwright: Playwright):
webkit = playwright.webkit
browser = webkit.launch(headless=False)
context = browser.new_context()
context.expose_binding("pageURL", lambda source: source["page"].url)
page = context.new_page()
page.set_content("""
<script>
async function onClick() {
document.querySelector('div').textContent = await window.pageURL();
}
</script>
<button onclick="onClick()">Click me</button>
<div></div>
""")
page.get_by_role("button").click()
with sync_playwright() as playwright:
run(playwright)
import asyncio
from playwright.async_api import async_playwright, Playwright
async def run(playwright: Playwright):
webkit = playwright.webkit
browser = await webkit.launch(headless=False)
context = await browser.new_context()
await context.expose_binding("pageURL", lambda source: source["page"].url)
page = await context.new_page()
await page.set_content("""
<script>
async function onClick() {
document.querySelector('div').textContent = await window.pageURL();
}
</script>
<button onclick="onClick()">Click me</button>
<div></div>
""")
await page.get_by_role("button").click()
async def main():
async with async_playwright() as playwright:
await run(playwright)
asyncio.run(main())
参数
-
window 对象上的函数名称。
-
将在 Playwright 上下文中调用的回调函数。
-
已弃用
此选项将来会被移除。
是否将参数作为 handle 传递,而不是按值传递。传递 handle 时,仅支持一个参数。按值传递时,支持多个参数。
返回
expose_function
添加于 v1.9 之前此方法会在上下文中每个页面的每个 frame 的 window
对象上添加一个名为 name 的函数。调用该函数时,它会执行 callback 并返回一个 Promise,该 Promise 解析为 callback 的返回值。
如果 callback 返回一个 Promise,则会等待其完成。
请参阅 page.expose_function() 获取仅页面版本。
用法
将 sha256 函数添加到上下文中所有页面的示例
- 同步
- 异步
import hashlib
from playwright.sync_api import sync_playwright
def sha256(text: str) -> str:
m = hashlib.sha256()
m.update(bytes(text, "utf8"))
return m.hexdigest()
def run(playwright: Playwright):
webkit = playwright.webkit
browser = webkit.launch(headless=False)
context = browser.new_context()
context.expose_function("sha256", sha256)
page = context.new_page()
page.set_content("""
<script>
async function onClick() {
document.querySelector('div').textContent = await window.sha256('PLAYWRIGHT');
}
</script>
<button onclick="onClick()">Click me</button>
<div></div>
""")
page.get_by_role("button").click()
with sync_playwright() as playwright:
run(playwright)
import asyncio
import hashlib
from playwright.async_api import async_playwright, Playwright
def sha256(text: str) -> str:
m = hashlib.sha256()
m.update(bytes(text, "utf8"))
return m.hexdigest()
async def run(playwright: Playwright):
webkit = playwright.webkit
browser = await webkit.launch(headless=False)
context = await browser.new_context()
await context.expose_function("sha256", sha256)
page = await context.new_page()
await page.set_content("""
<script>
async function onClick() {
document.querySelector('div').textContent = await window.sha256('PLAYWRIGHT');
}
</script>
<button onclick="onClick()">Click me</button>
<div></div>
""")
await page.get_by_role("button").click()
async def main():
async with async_playwright() as playwright:
await run(playwright)
asyncio.run(main())
参数
返回
grant_permissions
添加于 v1.9 之前授予浏览器上下文指定的权限。如果指定了 origin,则仅授予给定 origin 对应的权限。
用法
browser_context.grant_permissions(permissions)
browser_context.grant_permissions(permissions, **kwargs)
参数
-
要授予的权限列表。
危险支持的权限在不同浏览器之间,甚至同一浏览器的不同版本之间都不同。任何权限都可能在更新后停止工作。
以下是一些可能被某些浏览器支持的权限
'accelerometer'
'ambient-light-sensor'
'background-sync'
'camera'
'clipboard-read'
'clipboard-write'
'geolocation'
'gyroscope'
'magnetometer'
'microphone'
'midi-sysex'
(系统独占 midi)'midi'
'notifications'
'payment-handler'
'storage-access'
-
要授予权限的 origin,例如 "https://example.com"。
返回
new_cdp_session
添加于: v1.11CDP session 仅在基于 Chromium 的浏览器上支持。
返回新创建的 session。
用法
browser_context.new_cdp_session(page)
参数
返回
new_page
添加于 v1.9 之前在浏览器上下文中创建一个新页面。
用法
browser_context.new_page()
返回
route
添加于 v1.9 之前路由(Routing)提供了修改浏览器上下文中任何页面发出的网络请求的能力。启用路由后,每个匹配 url 模式的请求都会暂停,除非它被继续、完成或中止。
browser_context.route() 不会拦截被 Service Worker 拦截的请求。请参阅此问题。我们建议在使用请求拦截时通过将 service_workers 设置为 'block'
来禁用 Service Worker。
用法
一个简单的示例,演示如何中止所有图片请求
- 同步
- 异步
context = browser.new_context()
page = context.new_page()
context.route("**/*.{png,jpg,jpeg}", lambda route: route.abort())
page.goto("https://example.com")
browser.close()
context = await browser.new_context()
page = await context.new_page()
await context.route("**/*.{png,jpg,jpeg}", lambda route: route.abort())
await page.goto("https://example.com")
await browser.close()
或者使用正则表达式模式的相同代码片段
- 同步
- 异步
context = browser.new_context()
page = context.new_page()
context.route(re.compile(r"(\.png$)|(\.jpg$)"), lambda route: route.abort())
page = await context.new_page()
page = context.new_page()
page.goto("https://example.com")
browser.close()
context = await browser.new_context()
page = await context.new_page()
await context.route(re.compile(r"(\.png$)|(\.jpg$)"), lambda route: route.abort())
page = await context.new_page()
await page.goto("https://example.com")
await browser.close()
可以检查请求以决定路由操作。例如,模拟(mock)所有包含某些 post data 的请求,并保持所有其他请求不变
- 同步
- 异步
def handle_route(route: Route):
if ("my-string" in route.request.post_data):
route.fulfill(body="mocked-data")
else:
route.continue_()
context.route("/api/**", handle_route)
async def handle_route(route: Route):
if ("my-string" in route.request.post_data):
await route.fulfill(body="mocked-data")
else:
await route.continue_()
await context.route("/api/**", handle_route)
当请求同时匹配页面路由(通过 page.route() 设置)和浏览器上下文路由时,页面路由优先。
要移除一个路由及其 handler,可以使用 browser_context.unroute()。
启用路由会禁用 http 缓存。
参数
-
url
str | Pattern | Callable[URL]:bool#一个 glob 模式、regex 模式或接收一个 URL 以在路由期间匹配的 predicate。如果上下文选项中设置了 base_url 并且提供的 URL 是不以
*
开头的字符串,则使用new URL()
构造函数解析它。 -
handler
Callable[Route, Request]:Promise[Any] | Any#用于路由请求的 handler 函数。
-
路由应该多久使用一次。默认情况下,每次都会使用它。
返回
route_from_har
新增于: v1.23如果指定,则此上下文中的网络请求将从 HAR 文件提供。阅读有关重放 HAR的更多信息。
Playwright 不会从 HAR 文件提供被 Service Worker 拦截的请求。参阅此问题。建议在使用请求拦截时,通过将 service_workers 设置为 'block'
来禁用 Service Worker。
用法
browser_context.route_from_har(har)
browser_context.route_from_har(har, **kwargs)
参数
-
har
Union[str, pathlib.Path]#HAR 文件路径,包含预先记录的网络数据。如果
path
是相对路径,则它会相对于当前工作目录解析。 -
not_found
"abort" | "fallback" (可选)#- 如果设置为 'abort',则 HAR 文件中未找到的任何请求都将被中止。
- 如果设置为 'fallback',则会回退到处理程序链中的下一个路由处理程序。
默认为 abort。
-
如果指定,则使用实际的网络信息更新给定的 HAR 文件,而不是从文件提供。当调用 browser_context.close() 时,文件会被写入磁盘。
-
update_content
"embed" | "attach" (可选)新增于: v1.32#用于控制资源内容管理的可选设置。如果指定
attach
,资源将作为单独的文件或 ZIP 归档中的条目持久化。如果指定embed
,内容将内嵌存储在 HAR 文件中。 -
update_mode
"full" | "minimal" (可选)新增于: v1.32#设置为
minimal
时,仅记录从 HAR 路由所需的信息。这会省略大小、时间、页面、cookie、安全以及重放 HAR 时不使用的其他类型的 HAR 信息。默认为minimal
。 -
用于匹配请求 URL 的 glob 模式、正则表达式或谓词。只有 URL 匹配该模式的请求才会从 HAR 文件提供。如果未指定,则所有请求都从 HAR 文件提供。
返回
route_web_socket
新增于: v1.48此方法允许修改浏览器上下文中的任何页面建立的 websocket 连接。
请注意,只有在此方法调用后创建的 WebSocket
才会进行路由。建议在创建任何页面之前调用此方法。
用法
下面是一个简单的处理程序示例,它会阻止一些 websocket 消息。参阅 WebSocketRoute 获取更多详细信息和示例。
- 同步
- 异步
def message_handler(ws: WebSocketRoute, message: Union[str, bytes]):
if message == "to-be-blocked":
return
ws.send(message)
def handler(ws: WebSocketRoute):
ws.route_send(lambda message: message_handler(ws, message))
ws.connect()
context.route_web_socket("/ws", handler)
def message_handler(ws: WebSocketRoute, message: Union[str, bytes]):
if message == "to-be-blocked":
return
ws.send(message)
async def handler(ws: WebSocketRoute):
ws.route_send(lambda message: message_handler(ws, message))
await ws.connect()
await context.route_web_socket("/ws", handler)
参数
-
url
str | Pattern | Callable[URL]:bool#只有 URL 与此模式匹配的 WebSocket 会被路由。字符串模式可以相对于 base_url 上下文选项进行设置。
-
handler
Callable[WebSocketRoute]:Promise[Any] | Any#用于路由 WebSocket 的处理程序函数。
返回
set_default_navigation_timeout
添加于 v1.9 之前此设置将更改以下方法和相关快捷方式的默认最大导航时间
- page.go_back()
- page.go_forward()
- page.goto()
- page.reload()
- page.set_content()
- page.expect_navigation()
用法
browser_context.set_default_navigation_timeout(timeout)
参数
set_default_timeout
添加于 v1.9 之前此设置将更改接受 timeout 选项的所有方法的默认最大时间。
用法
browser_context.set_default_timeout(timeout)
参数
set_extra_http_headers
添加于 v1.9 之前额外的 HTTP 头部将随此上下文中的任何页面发起的每个请求一起发送。这些头部会与使用 page.set_extra_http_headers() 设置的页面特定额外 HTTP 头部合并。如果页面覆盖了某个特定头部,将使用页面特定的头部值而不是浏览器上下文的头部值。
browser_context.set_extra_http_headers() 不保证传出请求中头部的顺序。
用法
browser_context.set_extra_http_headers(headers)
参数
返回
set_geolocation
添加于 v1.9 之前设置上下文的地理位置。传入 null
或 undefined
会模拟位置不可用。
用法
- 同步
- 异步
browser_context.set_geolocation({"latitude": 59.95, "longitude": 30.31667})
await browser_context.set_geolocation({"latitude": 59.95, "longitude": 30.31667})
考虑使用 browser_context.grant_permissions() 来授予浏览器上下文页面读取其地理位置的权限。
参数
返回
set_offline
添加于 v1.9 之前用法
browser_context.set_offline(offline)
参数
返回
storage_state
添加于 v1.9 之前返回此浏览器上下文的存储状态,包含当前的 cookie、本地存储快照和 IndexedDB 快照。
用法
browser_context.storage_state()
browser_context.storage_state(**kwargs)
参数
-
indexed_db
bool (可选)新增于: v1.51#设置为
true
以在存储状态快照中包含 IndexedDB。如果您的应用程序使用 IndexedDB 存储身份验证令牌(例如 Firebase Authentication),请启用此选项。 -
path
Union[str, pathlib.Path] (可选)#保存存储状态的文件路径。如果 path 是相对路径,则它会相对于当前工作目录解析。如果没有提供路径,存储状态仍然会返回,但不会保存到磁盘。
返回
unroute
添加于 v1.9 之前移除使用 browser_context.route() 创建的路由。当未指定 handler 时,移除针对 url 的所有路由。
用法
browser_context.unroute(url)
browser_context.unroute(url, **kwargs)
参数
-
url
str | Pattern | Callable[URL]:bool#用于注册 browser_context.route() 路由时,用于接收 URL 的 glob 模式、正则表达式模式或谓词。
-
handler
Callable[Route, Request]:Promise[Any] | Any (可选)#用于注册 browser_context.route() 路由的可选处理程序函数。
返回
unroute_all
新增于: v1.41移除所有使用 browser_context.route() 和 browser_context.route_from_har() 创建的路由。
用法
browser_context.unroute_all()
browser_context.unroute_all(**kwargs)
参数
-
behavior
"wait" | "ignoreErrors" | "default" (可选)#指定是否等待已运行的处理程序完成,以及它们抛出错误时如何处理
'default'
- 不等待当前处理程序调用(如果有)完成,如果未路由的处理程序抛出错误,可能导致未处理的错误'wait'
- 等待当前处理程序调用(如果有)完成'ignoreErrors'
- 不等待当前处理程序调用(如果有)完成,取消路由后由处理程序抛出的所有错误将被静默捕获
返回
wait_for_event
添加于 v1.9 之前在大多数情况下,您应该使用 browser_context.expect_event()。
等待给定的 event
触发。如果提供了谓词,它会将事件值传递给 predicate
函数,并等待 predicate(event)
返回真值。如果在 event
触发之前浏览器上下文关闭,将抛出错误。
用法
browser_context.wait_for_event(event)
browser_context.wait_for_event(event, **kwargs)
参数
-
事件名称,通常与传递给
*.on(event)
的名称相同。 -
接收事件数据,并在等待应解决时解析为真值。
-
最大等待时间(毫秒)。默认为
30000
(30 秒)。传递0
禁用超时。默认值可以通过使用 browser_context.set_default_timeout() 更改。
返回
属性
background_pages
添加于: v1.11后台页面仅在基于 Chromium 的浏览器上受支持。
此上下文中所有现有的后台页面。
用法
browser_context.background_pages
返回
browser
添加于 v1.9 之前返回此上下文的浏览器实例。如果它是作为持久化上下文启动的,则返回 null。
用法
browser_context.browser
返回
clock
新增于: v1.45Playwright 具有模拟时钟和时间流逝的能力。
用法
browser_context.clock
类型
pages
添加于 v1.9 之前返回此上下文中所有打开的页面。
用法
browser_context.pages
返回
request
新增于: v1.16与此上下文关联的 API 测试助手。使用此 API 发送的请求将使用上下文的 cookie。
用法
browser_context.request
类型
service_workers
添加于: v1.11Service Worker 仅在基于 Chromium 的浏览器上受支持。
此上下文中所有现有的 Service Worker。
用法
browser_context.service_workers
返回
tracing
新增于: v1.12用法
browser_context.tracing
类型
事件
on("backgroundpage")
添加于: v1.11仅适用于 Chromium 浏览器的持久化上下文。
当在此上下文创建新的后台页面时触发。
- 同步
- 异步
background_page = context.wait_for_event("backgroundpage")
background_page = await context.wait_for_event("backgroundpage")
用法
browser_context.on("backgroundpage", handler)
事件数据
on("close")
添加于 v1.9 之前当浏览器上下文关闭时触发。可能由以下原因之一导致
- 浏览器上下文已关闭。
- 浏览器应用程序已关闭或崩溃。
- 调用了 browser.close() 方法。
用法
browser_context.on("close", handler)
事件数据
on("console")
添加于: v1.34当页面中的 JavaScript 调用其中一个控制台 API 方法时触发,例如 console.log
或 console.dir
。
传递给 console.log
和页面的参数可在 ConsoleMessage 事件处理程序参数中获取。
用法
- 同步
- 异步
def print_args(msg):
for arg in msg.args:
print(arg.json_value())
context.on("console", print_args)
page.evaluate("console.log('hello', 5, { foo: 'bar' })")
async def print_args(msg):
values = []
for arg in msg.args:
values.append(await arg.json_value())
print(values)
context.on("console", print_args)
await page.evaluate("console.log('hello', 5, { foo: 'bar' })")
事件数据
on("dialog")
添加于: v1.34当出现 JavaScript 对话框时触发,例如 alert
、prompt
、confirm
或 beforeunload
。监听器必须调用 dialog.accept() 或 dialog.dismiss() 来处理对话框 - 否则页面将冻结,等待对话框,且点击等操作将永远无法完成。
用法
context.on("dialog", lambda dialog: dialog.accept())
如果没有 page.on("dialog") 或 browser_context.on("dialog") 监听器,所有对话框将自动关闭。
事件数据
on("page")
添加于 v1.9 之前当在 BrowserContext 中创建一个新的 Page 时触发此事件。页面可能仍在加载中。此事件也会为弹出页面触发。另请参阅 page.on("popup") 以接收与特定页面相关的弹出窗口事件。
页面可用的最早时刻是它导航到初始 URL 时。例如,当使用 window.open('http://example.com')
打开弹出窗口时,当针对 "http://example.com" 的网络请求完成且其响应开始在弹出窗口中加载时,将触发此事件。如果您想对此网络请求进行路由/监听,请分别使用 browser_context.route() 和 browser_context.on("request"),而不是 Page 上的类似方法。
- 同步
- 异步
with context.expect_page() as page_info:
page.get_by_text("open new page").click(),
page = page_info.value
print(page.evaluate("location.href"))
async with context.expect_page() as page_info:
await page.get_by_text("open new page").click(),
page = await page_info.value
print(await page.evaluate("location.href"))
使用 page.wait_for_load_state() 可以等待页面达到特定状态(大多数情况下不需要此操作)。
用法
browser_context.on("page", handler)
事件数据
on("request")
新增于: v1.12当从通过此上下文创建的任何页面发出请求时触发。此 request 对象是只读的。要仅监听来自特定页面的请求,请使用 page.on("request")。
要拦截和修改请求,请参阅 browser_context.route() 或 page.route()。
用法
browser_context.on("request", handler)
事件数据
on("requestfailed")
新增于: v1.12当请求失败时触发,例如因超时。要仅监听来自特定页面的失败请求,请使用 page.on("requestfailed")。
从 HTTP 的角度来看,HTTP 错误响应(例如 404 或 503)仍然是成功的响应,因此请求将以 browser_context.on("requestfinished") 事件完成,而不是以 browser_context.on("requestfailed") 事件完成。
用法
browser_context.on("requestfailed", handler)
事件数据
on("requestfinished")
新增于: v1.12当请求成功完成并下载响应正文后触发。对于成功的响应,事件顺序是 request
、response
和 requestfinished
。要监听来自特定页面的成功请求,请使用 page.on("requestfinished")。
用法
browser_context.on("requestfinished", handler)
事件数据
on("response")
新增于: v1.12当收到请求的 response 状态和头部时触发。对于成功的响应,事件顺序是 request
、response
和 requestfinished
。要监听来自特定页面的响应事件,请使用 page.on("response")。
用法
browser_context.on("response", handler)
事件数据
on("serviceworker")
添加于: v1.11Service Worker 仅在基于 Chromium 的浏览器上受支持。
当在此上下文创建新的 Service Worker 时触发。
用法
browser_context.on("serviceworker", handler)
事件数据
on("weberror")
新增于: v1.38当在此上下文中的任何页面中出现未处理的异常时触发。要监听来自特定页面的错误,请改用 page.on("pageerror")。
用法
browser_context.on("weberror", handler)
事件数据