Browser

浏览器是通过 browser_type.launch() 创建的。使用 Browser 创建 Page 的示例：

🌐 A Browser is created via browser_type.launch(). An example of using a Browser to create a Page:

Sync
Async

from playwright.sync_api import sync_playwright, Playwright

def run(playwright: Playwright):
    firefox = playwright.firefox
    browser = firefox.launch()
    page = browser.new_page()
    page.goto("https://example.com")
    browser.close()

with sync_playwright() as playwright:
    run(playwright)

import asyncio
from playwright.async_api import async_playwright, Playwright

async def run(playwright: Playwright):
    firefox = playwright.firefox
    browser = await firefox.launch()
    page = await browser.new_page()
    await page.goto("https://example.com")
    await browser.close()

async def main():
    async with async_playwright() as playwright:
        await run(playwright)
asyncio.run(main())

方法

🌐 Methods

close

Added before v1.9

browser.close

如果这个浏览器是通过 browser_type.launch() 获取的，会关闭浏览器及其所有页面（如果有打开的话）。

🌐 In case this browser is obtained using browser_type.launch(), closes the browser and all of its pages (if any were opened).

如果连接到此浏览器，则清除属于此浏览器的所有创建的上下文并断开与浏览器服务器的连接。

🌐 In case this browser is connected to, clears all created contexts belonging to this browser and disconnects from the browser server.

note

这类似于强制退出浏览器。要优雅地关闭页面并确保你收到页面关闭事件，请在调用 browser.close() 之前，对你之前使用 browser.new_context() 明确创建的任何 BrowserContext 实例调用 browser_context.close() 。

🌐 This is similar to force-quitting the browser. To close pages gracefully and ensure you receive page close events, call browser_context.close() on any BrowserContext instances you explicitly created earlier using browser.new_context() before calling browser.close().

【Browser】对象本身已被认为是已释放状态，不能再使用。

🌐 The Browser object itself is considered to be disposed and cannot be used anymore.

用法

browser.close()
browser.close(**kwargs)

参数

reason str (optional) Added in: v1.40#

报告的原因是由于浏览器关闭而中断的操作。

NoneType #

new_browser_cdp_session

Added in: v1.11

browser.new_browser_cdp_session

note

CDP 会话仅支持基于 Chromium 的浏览器。

🌐 CDP Sessions are only supported on Chromium-based browsers.

返回新创建的浏览器会话。

🌐 Returns the newly created browser session.

用法

browser.new_browser_cdp_session()

CDPSession #

new_context

Added before v1.9

browser.new_context

创建一个新的浏览器上下文。它不会与其他浏览器上下文共享 cookies 或缓存。

🌐 Creates a new browser context. It won't share cookies/cache with other browser contexts.

note

如果直接使用此方法创建 BrowserContext，最佳做法是在代码使用完 BrowserContext 后，并在调用 browser.close() 之前，显式关闭返回的上下文，通过 browser_context.close() 实现。这样可以确保 context 被优雅地关闭，并且任何生成的文件——例如 HAR 文件和视频——都能完全刷新并保存。

🌐 If directly using this method to create BrowserContexts, it is best practice to explicitly close the returned context via browser_context.close() when your code is done with the BrowserContext, and before calling browser.close(). This will ensure the context is closed gracefully and any artifacts—like HARs and videos—are fully flushed and saved.

用法

Sync
Async

browser = playwright.firefox.launch() # or "chromium" or "webkit".
# create a new incognito browser context.
context = browser.new_context()
# create a new page in a pristine context.
page = context.new_page()
page.goto("https://example.com")

# gracefully close up everything
context.close()
browser.close()

browser = await playwright.firefox.launch() # or "chromium" or "webkit".
# create a new incognito browser context.
context = await browser.new_context()
# create a new page in a pristine context.
page = await context.new_page()
await page.goto("https://example.com")

# gracefully close up everything
await context.close()
await browser.close()

参数

accept_downloads bool (optional)#

是否自动下载所有附件。默认值为 true，表示接受所有下载。
base_url str (optional)#

在使用 page.goto()、page.route()、page.wait_for_url()、page.expect_request() 或 page.expect_response() 时，会通过使用 URL() 构造函数构建相应的 URL 来考虑基础 URL。默认情况下未设置。示例:
- baseURL：http://localhost:3000，然后导航到 /bar.html 会得到 http://localhost:3000/bar.html
- baseURL：http://localhost:3000/foo/，然后导航到 ./bar.html 会得到 http://localhost:3000/foo/bar.html
- baseURL: http://localhost:3000/foo（不带末尾斜杠），然后导航到 ./bar.html 会得到 http://localhost:3000/bar.html
bypass_csp bool (optional)#

切换是否绕过页面的内容安全策略。默认值为 false。
client_certificates List[Dict] (optional) Added in: 1.46#
- origin str
  
  证书有效的确切来源。来源包括 https 协议、主机名以及可选的端口。
- certPath Union[str, pathlib.Path] (optional)
  
  PEM 格式的证书文件路径。
- cert bytes (optional)
  
  PEM 格式的证书的直接值。
- keyPath Union[str, pathlib.Path] (optional)
  
  PEM 格式的私钥文件路径。
- key bytes (optional)
  
  PEM 格式的私钥的直接值。
- pfxPath Union[str, pathlib.Path] (optional)
  
  PFX 或 PKCS12 编码的私钥和证书链的路径。
- pfx bytes (optional)
  
  PFX 或 PKCS12 编码的私钥和证书链的直接值。
- passphrase str (optional)
  
  私钥的密码（PEM 或 PFX）。
TLS 客户端身份验证允许服务器请求客户端证书并对其进行验证。

详情

要使用的一组客户端证书。每个证书对象必须同时具有 certPath 和 keyPath，或者单独具有 pfxPath，或它们对应的直接值等效项（cert 和 key，或 pfx）。如果证书是加密的，则可选择提供 passphrase 属性。origin 属性应提供与证书有效的请求来源完全匹配的值。

客户端证书认证仅在提供至少一个客户端证书时才有效。如果你想拒绝服务器发送的所有客户端证书，你需要提供一个 origin 与你计划访问的任何域名都不匹配的客户端证书。

note
在 macOS 上使用 WebKit 时，访问 localhost 不会使用客户端证书。你可以通过将 localhost 替换为 local.playwright 来使其正常工作。
color_scheme "light" | "dark" | "no-preference" | "null" (optional)#

模拟 prefers-colors-scheme 媒体特性，支持的值为 'light' 和 'dark'。更多详情请参见 page.emulate_media()。传递 'null' 会将模拟重置为系统默认值。默认值为 'light'。
contrast "no-preference" | "more" | "null" (optional)#

模拟 'prefers-contrast' 媒体特性，支持的值为 'no-preference'、'more'。更多详情请参见 page.emulate_media()。传递 'null' 会将模拟重置为系统默认值。默认为 'no-preference'。
device_scale_factor float (optional)#

指定设备缩放因子（可以理解为 DPR）。默认值为 1。了解有关使用设备缩放因子模拟设备的更多信息。
extra_http_headers Dict[str, str] (optional)#

一个包含附加 HTTP 头的对象，这些头将随每个请求发送。默认为无。
forced_colors "active" | "none" | "null" (optional)#

模拟 'forced-colors' 媒体特性，支持的值为 'active'、'none'。更多详情请参见 page.emulate_media()。传递 'null' 会将模拟重置为系统默认值。默认为 'none'。
geolocation Dict (optional)#
- latitude float
  
  纬度在 -90 到 90 之间。
- longitude float
  
  经度在 -180 到 180 之间。
- accuracy float (optional)
  
  非负精度值。默认值为 0。
has_touch bool (optional)#

指定视口是否支持触摸事件。默认值为 false。了解更多关于移动模拟的信息。
http_credentials Dict (optional)#
- username str
- password str
- origin str (optional)
  
  限制在特定来源 (scheme://host:port) 上发送 http 凭据。
- send "unauthorized" | "always" (optional)
  
  此选项仅适用于从对应的 APIRequestContext 发送的请求，并不影响从浏览器发送的请求。'always' - Authorization 头信息会随每个 API 请求发送基本认证凭据。'unauthorized - 凭据仅在收到带有 WWW-Authenticate 头的 401（未授权）响应时发送。默认为 'unauthorized'。
HTTP 认证的凭据。如果未指定来源，用户名和密码将在收到未授权响应时发送到任何服务器。
ignore_https_errors bool (optional)#

发送网络请求时是否忽略 HTTPS 错误。默认值为 false。
is_mobile bool (optional)#

是否考虑 meta viewport 标签并启用触摸事件。isMobile 是 device 的一部分，因此你实际上不需要手动设置它。默认值为 false，并且在 Firefox 中不受支持。了解更多关于移动端模拟的信息。
java_script_enabled bool (optional)#

是否在此环境中启用 JavaScript。默认为 true。了解更多关于禁用 JavaScript的信息。
locale str (optional)#

指定用户区域设置，例如 en-GB、de-DE 等。区域设置会影响 navigator.language 的值、Accept-Language 请求头的值以及数字和日期的格式规则。默认为系统默认区域设置。有关模拟的更多信息，请参阅我们的模拟指南。
no_viewport bool (optional)#

不强制固定视口，允许在头显模式下调整窗口大小。
offline bool (optional)#

是否模拟网络离线。默认为 false。了解更多关于网络模拟的信息。
permissions List[str] (optional)#

在此上下文中授予所有页面的权限列表。有关更多详细信息，请参阅 browser_context.grant_permissions()。默认情况下为无。
proxy Dict (optional)#
- server str
  
  用于所有请求的代理。支持 HTTP 和 SOCKS 代理，例如 http://myproxy.com:3128 或 socks5://myproxy.com:3128。简写 myproxy.com:3128 被视为 HTTP 代理。
- bypass str (optional)
  
  可选的以逗号分隔的域名，用于绕过代理，例如 ".com, chromium.org, .domain.com"。
- username str (optional)
  
  如果 HTTP 代理需要身份验证，则使用可选的用户名。
- password str (optional)
  
  如果 HTTP 代理需要身份验证，则使用可选密码。
在此上下文中使用的网络代理设置。默认情况下为无。
record_har_content "omit" | "embed" | "attach" (optional)#

可选设置，用于控制资源内容管理。如果指定 omit，内容不会被保存。如果指定 attach，资源将作为单独的文件保存，并且所有这些文件会与 HAR 文件一起归档。默认值为 embed，根据 HAR 规范将内容以内联方式存储在 HAR 文件中。
record_har_mode "full" | "minimal" (optional)#

当设置为 minimal 时，仅记录从 HAR 路由所需的信息。这会省略在从 HAR 回放时不使用的大小、时间、页面、Cookies、安全性以及其他类型的 HAR 信息。默认值为 full。
record_har_omit_content bool (optional)#

可选设置，用于控制是否从 HAR 中省略请求内容。默认值为 false。
record_har_path Union[str, pathlib.Path] (optional)#

启用将所有页面的 HAR 记录到文件系统中指定的 HAR 文件。如果未指定，则不会记录 HAR。请确保调用 browser_context.close() 以保存 HAR。
record_har_url_filter str | Pattern (optional)#
record_video_dir Union[str, pathlib.Path] (optional)#

启用将所有页面的视频录制到指定目录。如果未指定，则不记录视频。请确保调用 browser_context.close() 以保存视频。
record_video_size Dict (optional)#
- width int
  
  视频帧宽度。
- height int
  
  视频帧高度。
录制视频的尺寸。如果未指定，尺寸将等于 viewport，并缩小以适应 800x800。如果未明确配置 viewport，视频尺寸默认为 800x450。如有必要，每一页的实际图片将被缩小以适应指定尺寸。
reduced_motion "reduce" | "no-preference" | "null" (optional)#

模拟 'prefers-reduced-motion' 媒体特性，支持的值为 'reduce'、'no-preference'。更多详情请参见 page.emulate_media()。传递 'null' 会将模拟重置为系统默认值。默认为 'no-preference'。
screen Dict (optional)#
- width int
  
  页面宽度（以像素为单位）。
- height int
  
  页面高度（以像素为单位）。
通过 window.screen 模拟网页内可用的一致窗口屏幕大小。仅在设置了 viewport 时使用。
service_workers "allow" | "block" (optional)#

是否允许网站注册服务工作进程。默认值为 'allow'。
- 'allow'：服务工作者可以被注册。
- 'block'：Playwright 将阻止所有服务工作进程的注册。
storage_state Union[str, pathlib.Path] | Dict (optional)#
- cookies List[Dict]
  - name str
  - value str
  - domain str
    
    域和路径是必填项。若要使 cookie 适用于所有子域，请在域名前加一个点，如：.example.com
  - path str
    
    域名和路径为必填项
  - expires float
    
    Unix 时间以秒为单位。
  - httpOnly bool
  - secure bool
  - sameSite “严格” | “宽松” | “无”
    
    同一站点标志
  为上下文设置的 Cookie
- origins List[Dict]
  - origin str
  - localStorage List[Dict]
    - name str
    - value str
    localStorage 设置上下文
了解更多关于存储状态和身份验证的信息。

使用给定的存储状态填充上下文。此选项可用于使用通过 browser_context.storage_state() 获取的登录信息初始化上下文。
strict_selectors bool (optional)#

如果设置为 true，则为此上下文启用严格选择器模式。在严格选择器模式下，对选择器进行的所有操作，如果操作意图是单个目标 DOM 元素，当有多个元素匹配选择器时将会抛出错误。此选项不会影响任何定位器（Locator）API（定位器始终是严格的）。默认值为 false。请参阅 Locator 了解有关严格模式的更多信息。
timezone_id str (optional)#

更改上下文的时区。有关支持的时区 ID 列表，请参阅 ICU 的 metaZones.txt。默认使用系统时区。
user_agent str (optional)#

在此上下文中使用的特定用户代理。
viewport NoneType | Dict (optional)#
- width int
  
  页面宽度（以像素为单位）。
- height int
  
  页面高度（以像素为单位）。
为每个页面设置一致的视口。默认视口为1280x720。no_viewport 禁用固定视口。了解更多关于视口模拟的信息。

BrowserContext #

new_page

Added before v1.9

browser.new_page

在新的浏览器上下文中创建一个新页面。关闭此页面也会关闭该上下文。

🌐 Creates a new page in a new browser context. Closing this page will close the context as well.

这是一个便捷的 API，只应在单页场景和简短片段中使用。生产代码和测试框架应显式创建 browser.new_context()，然后调用 browser_context.new_page() 以精确控制它们的生命周期。

🌐 This is a convenience API that should only be used for the single-page scenarios and short snippets. Production code and testing frameworks should explicitly create browser.new_context() followed by the browser_context.new_page() to control their exact life times.

用法

browser.new_page()
browser.new_page(**kwargs)

参数

accept_downloads bool (optional)#

是否自动下载所有附件。默认值为 true，表示接受所有下载。
base_url str (optional)#

在使用 page.goto()、page.route()、page.wait_for_url()、page.expect_request() 或 page.expect_response() 时，会通过使用 URL() 构造函数构建相应的 URL 来考虑基础 URL。默认情况下未设置。示例:
- baseURL：http://localhost:3000，然后导航到 /bar.html 会得到 http://localhost:3000/bar.html
- baseURL：http://localhost:3000/foo/，然后导航到 ./bar.html 会得到 http://localhost:3000/foo/bar.html
- baseURL: http://localhost:3000/foo（不带末尾斜杠），然后导航到 ./bar.html 会得到 http://localhost:3000/bar.html
bypass_csp bool (optional)#

切换是否绕过页面的内容安全策略。默认值为 false。
client_certificates List[Dict] (optional) Added in: 1.46#
- origin str
  
  证书有效的确切来源。来源包括 https 协议、主机名以及可选的端口。
- certPath Union[str, pathlib.Path] (optional)
  
  PEM 格式的证书文件路径。
- cert bytes (optional)
  
  PEM 格式的证书的直接值。
- keyPath Union[str, pathlib.Path] (optional)
  
  PEM 格式的私钥文件路径。
- key bytes (optional)
  
  PEM 格式的私钥的直接值。
- pfxPath Union[str, pathlib.Path] (optional)
  
  PFX 或 PKCS12 编码的私钥和证书链的路径。
- pfx bytes (optional)
  
  PFX 或 PKCS12 编码的私钥和证书链的直接值。
- passphrase str (optional)
  
  私钥的密码（PEM 或 PFX）。
TLS 客户端身份验证允许服务器请求客户端证书并对其进行验证。

详情

要使用的一组客户端证书。每个证书对象必须同时具有 certPath 和 keyPath，或者单独具有 pfxPath，或它们对应的直接值等效项（cert 和 key，或 pfx）。如果证书是加密的，则可选择提供 passphrase 属性。origin 属性应提供与证书有效的请求来源完全匹配的值。

客户端证书认证仅在提供至少一个客户端证书时才有效。如果你想拒绝服务器发送的所有客户端证书，你需要提供一个 origin 与你计划访问的任何域名都不匹配的客户端证书。

note
在 macOS 上使用 WebKit 时，访问 localhost 不会使用客户端证书。你可以通过将 localhost 替换为 local.playwright 来使其正常工作。
color_scheme "light" | "dark" | "no-preference" | "null" (optional)#

模拟 prefers-colors-scheme 媒体特性，支持的值为 'light' 和 'dark'。更多详情请参见 page.emulate_media()。传递 'null' 会将模拟重置为系统默认值。默认值为 'light'。
contrast "no-preference" | "more" | "null" (optional)#

模拟 'prefers-contrast' 媒体特性，支持的值为 'no-preference'、'more'。更多详情请参见 page.emulate_media()。传递 'null' 会将模拟重置为系统默认值。默认为 'no-preference'。
device_scale_factor float (optional)#

指定设备缩放因子（可以理解为 DPR）。默认值为 1。了解有关使用设备缩放因子模拟设备的更多信息。
extra_http_headers Dict[str, str] (optional)#

一个包含附加 HTTP 头的对象，这些头将随每个请求发送。默认为无。
forced_colors "active" | "none" | "null" (optional)#

模拟 'forced-colors' 媒体特性，支持的值为 'active'、'none'。更多详情请参见 page.emulate_media()。传递 'null' 会将模拟重置为系统默认值。默认为 'none'。
geolocation Dict (optional)#
- latitude float
  
  纬度在 -90 到 90 之间。
- longitude float
  
  经度在 -180 到 180 之间。
- accuracy float (optional)
  
  非负精度值。默认值为 0。
has_touch bool (optional)#

指定视口是否支持触摸事件。默认值为 false。了解更多关于移动模拟的信息。
http_credentials Dict (optional)#
- username str
- password str
- origin str (optional)
  
  限制在特定来源 (scheme://host:port) 上发送 http 凭据。
- send "unauthorized" | "always" (optional)
  
  此选项仅适用于从对应的 APIRequestContext 发送的请求，并不影响从浏览器发送的请求。'always' - Authorization 头信息会随每个 API 请求发送基本认证凭据。'unauthorized - 凭据仅在收到带有 WWW-Authenticate 头的 401（未授权）响应时发送。默认为 'unauthorized'。
HTTP 认证的凭据。如果未指定来源，用户名和密码将在收到未授权响应时发送到任何服务器。
ignore_https_errors bool (optional)#

发送网络请求时是否忽略 HTTPS 错误。默认值为 false。
is_mobile bool (optional)#

是否考虑 meta viewport 标签并启用触摸事件。isMobile 是 device 的一部分，因此你实际上不需要手动设置它。默认值为 false，并且在 Firefox 中不受支持。了解更多关于移动端模拟的信息。
java_script_enabled bool (optional)#

是否在此环境中启用 JavaScript。默认为 true。了解更多关于禁用 JavaScript的信息。
locale str (optional)#

指定用户区域设置，例如 en-GB、de-DE 等。区域设置会影响 navigator.language 的值、Accept-Language 请求头的值以及数字和日期的格式规则。默认为系统默认区域设置。有关模拟的更多信息，请参阅我们的模拟指南。
no_viewport bool (optional)#

不强制固定视口，允许在头显模式下调整窗口大小。
offline bool (optional)#

是否模拟网络离线。默认为 false。了解更多关于网络模拟的信息。
permissions List[str] (optional)#

在此上下文中授予所有页面的权限列表。有关更多详细信息，请参阅 browser_context.grant_permissions()。默认情况下为无。
proxy Dict (optional)#
- server str
  
  用于所有请求的代理。支持 HTTP 和 SOCKS 代理，例如 http://myproxy.com:3128 或 socks5://myproxy.com:3128。简写 myproxy.com:3128 被视为 HTTP 代理。
- bypass str (optional)
  
  可选的以逗号分隔的域名，用于绕过代理，例如 ".com, chromium.org, .domain.com"。
- username str (optional)
  
  如果 HTTP 代理需要身份验证，则使用可选的用户名。
- password str (optional)
  
  如果 HTTP 代理需要身份验证，则使用可选密码。
在此上下文中使用的网络代理设置。默认情况下为无。
record_har_content "omit" | "embed" | "attach" (optional)#

可选设置，用于控制资源内容管理。如果指定 omit，内容不会被保存。如果指定 attach，资源将作为单独的文件保存，并且所有这些文件会与 HAR 文件一起归档。默认值为 embed，根据 HAR 规范将内容以内联方式存储在 HAR 文件中。
record_har_mode "full" | "minimal" (optional)#

当设置为 minimal 时，仅记录从 HAR 路由所需的信息。这会省略在从 HAR 回放时不使用的大小、时间、页面、Cookies、安全性以及其他类型的 HAR 信息。默认值为 full。
record_har_omit_content bool (optional)#

可选设置，用于控制是否从 HAR 中省略请求内容。默认值为 false。
record_har_path Union[str, pathlib.Path] (optional)#

启用将所有页面的 HAR 记录到文件系统中指定的 HAR 文件。如果未指定，则不会记录 HAR。请确保调用 browser_context.close() 以保存 HAR。
record_har_url_filter str | Pattern (optional)#
record_video_dir Union[str, pathlib.Path] (optional)#

启用将所有页面的视频录制到指定目录。如果未指定，则不记录视频。请确保调用 browser_context.close() 以保存视频。
record_video_size Dict (optional)#
- width int
  
  视频帧宽度。
- height int
  
  视频帧高度。
录制视频的尺寸。如果未指定，尺寸将等于 viewport，并缩小以适应 800x800。如果未明确配置 viewport，视频尺寸默认为 800x450。如有必要，每一页的实际图片将被缩小以适应指定尺寸。
reduced_motion "reduce" | "no-preference" | "null" (optional)#

模拟 'prefers-reduced-motion' 媒体特性，支持的值为 'reduce'、'no-preference'。更多详情请参见 page.emulate_media()。传递 'null' 会将模拟重置为系统默认值。默认为 'no-preference'。
screen Dict (optional)#
- width int
  
  页面宽度（以像素为单位）。
- height int
  
  页面高度（以像素为单位）。
通过 window.screen 模拟网页内可用的固定窗口屏幕大小。仅在设置了 viewport 时使用。
service_workers "allow" | "block" (optional)#

是否允许网站注册服务工作进程。默认值为 'allow'。
- 'allow'：服务工作者可以被注册。
- 'block'：Playwright 将阻止所有服务工作进程的注册。
storage_state Union[str, pathlib.Path] | Dict (optional)#
- cookies List[Dict]
  - name str
  - value str
  - domain str
    
    域和路径是必填项。若要使 cookie 适用于所有子域，请在域名前加一个点，如：.example.com
  - path str
    
    域名和路径为必填项
  - expires float
    
    Unix 时间以秒为单位。
  - httpOnly bool
  - secure bool
  - sameSite “严格” | “宽松” | “无”
    
    同一站点标志
  为上下文设置的 Cookie
- origins List[Dict]
  - origin str
  - localStorage List[Dict]
    - name str
    - value str
    localStorage 设置上下文
了解更多关于存储状态和身份验证的信息。

使用给定的存储状态填充上下文。此选项可用于使用通过 browser_context.storage_state() 获取的登录信息初始化上下文。
strict_selectors bool (optional)#

如果设置为 true，则为此上下文启用严格选择器模式。在严格选择器模式下，对选择器进行的所有操作，如果操作意图是单个目标 DOM 元素，当有多个元素匹配选择器时将会抛出错误。此选项不会影响任何定位器（Locator）API（定位器始终是严格的）。默认值为 false。请参阅 Locator 了解有关严格模式的更多信息。
timezone_id str (optional)#

更改上下文的时区。有关支持的时区 ID 列表，请参阅 ICU 的 metaZones.txt。默认使用系统时区。
user_agent str (optional)#

在此上下文中使用的特定用户代理。
viewport NoneType | Dict (optional)#
- width int
  
  页面宽度（以像素为单位）。
- height int
  
  页面高度（以像素为单位）。
为每个页面设置一致的视口。默认视口为1280x720。no_viewport 禁用固定视口。了解更多关于视口模拟的信息。

Page #

start_tracing

Added in: v1.11

browser.start_tracing

note

此 API 控制 Chromium Tracing，这是一个低级别的特定于 Chromium 的调试工具。控制 Playwright Tracing 的 API 可以在这里找到。

🌐 This API controls Chromium Tracing which is a low-level chromium-specific debugging tool. API to control Playwright Tracing could be found here.

你可以使用 browser.start_tracing() 和 browser.stop_tracing() 来创建一个可在 Chrome 开发者工具性能面板中打开的跟踪文件。

🌐 You can use browser.start_tracing() and browser.stop_tracing() to create a trace file that can be opened in Chrome DevTools performance panel.

用法

Sync
Async

browser.start_tracing(page, path="trace.json")
page.goto("https://www.google.com")
browser.stop_tracing()

await browser.start_tracing(page, path="trace.json")
await page.goto("https://www.google.com")
await browser.stop_tracing()

参数

page Page (optional)#

可选（如果指定），跟踪包括给定页面的屏幕截图。
categories List[str] (optional)#

指定要使用的自定义类别而不是默认类别。
path Union[str, pathlib.Path] (optional)#

写入跟踪文件的路径。
screenshots bool (optional)#

捕获跟踪中的屏幕截图。

NoneType #

stop_tracing

Added in: v1.11

browser.stop_tracing

note

此 API 控制 Chromium Tracing，这是一个低级别的特定于 Chromium 的调试工具。控制 Playwright Tracing 的 API 可以在这里找到。

🌐 This API controls Chromium Tracing which is a low-level chromium-specific debugging tool. API to control Playwright Tracing could be found here.

返回带有跟踪数据的缓冲区。

🌐 Returns the buffer with trace data.

用法

browser.stop_tracing()

bytes #

属性

🌐 Properties

browser_type

Added in: v1.23

browser.browser_type

获取浏览器所属的浏览器类型（chromium、firefox 或 webkit）。

🌐 Get the browser type (chromium, firefox or webkit) that the browser belongs to.

用法

browser.browser_type

BrowserType #

contexts

Added before v1.9

browser.contexts

返回所有打开的浏览器上下文的数组。在新创建的浏览器中，这将返回零个浏览器上下文。

🌐 Returns an array of all open browser contexts. In a newly created browser, this will return zero browser contexts.

用法

Sync
Async

browser = pw.webkit.launch()
print(len(browser.contexts)) # prints `0`
context = browser.new_context()
print(len(browser.contexts)) # prints `1`

browser = await pw.webkit.launch()
print(len(browser.contexts)) # prints `0`
context = await browser.new_context()
print(len(browser.contexts)) # prints `1`

List[BrowserContext]#

is_connected

Added before v1.9

browser.is_connected

表示浏览器已连接。

🌐 Indicates that the browser is connected.

用法

browser.is_connected()

bool #

version

Added before v1.9

browser.version

返回浏览器版本。

🌐 Returns the browser version.

用法

browser.version

str #

事件

🌐 Events

on("disconnected")

Added before v1.9

browser.on("disconnected")

当浏览器与浏览器应用断开连接时触发。这可能由以下原因之一导致：

🌐 Emitted when Browser gets disconnected from the browser application. This might happen because of one of the following:

浏览器应用已关闭或崩溃。
已调用 browser.close() 方法。

用法

browser.on("disconnected", handler)

事件数据

Browser

方法​

close​

new_browser_cdp_session​

new_context​

new_page​

start_tracing​

stop_tracing​

属性​

browser_type​

contexts​

is_connected​

version​

事件​

on("disconnected")​

方法

close

new_browser_cdp_session

new_context

new_page

start_tracing

stop_tracing

属性

browser_type

contexts

is_connected

version

事件

on("disconnected")