Request

每当页面发送网络资源请求时，[页面] 会触发以下一系列事件：

🌐 Whenever the page sends a request for a network resource the following sequence of events are emitted by Page:

当页面发出请求时，会触发 page.on("request") 事件。
page.on("response") 在请求的响应状态和头部被接收时/如果被接收时触发。
page.on("requestfinished") 在响应主体下载完成且请求完成时触发。

如果请求在某个阶段失败，那么会触发 page.on("requestfailed") 事件，而不是 'requestfinished' 事件（也可能不是 'response' 事件）。

🌐 If request fails at some point, then instead of 'requestfinished' event (and possibly instead of 'response' event), the page.on("requestfailed") event is emitted.

note

HTTP 错误响应，例如 404 或 503，从 HTTP 的角度来看仍然是成功的响应，因此请求将以 'requestfinished' 事件完成。:::

🌐 HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request will complete with 'requestfinished' event.

如果请求收到“重定向”响应，请求会通过 requestfinished 事件成功完成，并且会向重定向的 URL 发起新的请求。

🌐 If request gets a 'redirect' response, the request is successfully finished with the requestfinished event, and a new request is issued to a redirected url.

方法

🌐 Methods

all_headers

Added in: v1.15

request.all_headers

一个包含与此请求关联的所有 HTTP 请求头的对象。头部名称为小写。

🌐 An object with all the request HTTP headers associated with this request. The header names are lower-cased.

用法

request.all_headers()

Dict[str, str]#

header_value

Added in: v1.15

request.header_value

返回与名称匹配的头部的值。名称不区分大小写。

🌐 Returns the value of the header matching the name. The name is case-insensitive.

用法

request.header_value(name)

参数

name str #

标头的名称。

NoneType | str #

headers_array

Added in: v1.15

request.headers_array

包含与此请求关联的所有请求 HTTP 头的数组。与 request.all_headers() 不同，头名称不会被转换为小写。具有多个条目的头，例如 Set-Cookie，会在数组中出现多次。

🌐 An array with all the request HTTP headers associated with this request. Unlike request.all_headers(), header names are NOT lower-cased. Headers with multiple entries, such as Set-Cookie, appear in the array multiple times.

用法

request.headers_array()

List[Dict]#
- name str
  
  标头的名称。
- value str
  
  标头的值。

response

Added before v1.9

request.response

返回匹配的 Response 对象，如果由于错误未收到响应，则返回 null。

🌐 Returns the matching Response object, or null if the response was not received due to error.

用法

request.response()

NoneType | Response #

sizes

Added in: v1.15

request.sizes

返回给定请求的资源大小信息。

🌐 Returns resource size information for given request.

用法

request.sizes()

Dict#
- requestBodySize int
  
  请求体（POST 数据负载）的大小，以字节为单位。如果没有请求体，则设置为 0。
- requestHeadersSize int
  
  从 HTTP 请求消息开始到（并包括）正文之前的双 CRLF 的总字节数。
- responseBodySize int
  
  收到的响应正文（编码）的大小（以字节为单位）。
- responseHeadersSize int
  
  从 HTTP 响应消息开始到（并包括）正文之前的双 CRLF 的总字节数。

属性

🌐 Properties

failure

Added before v1.9

request.failure

除非该请求失败并由 requestfailed 事件报告，否则该方法返回 null。

🌐 The method returns null unless this request has failed, as reported by requestfailed event.

用法

记录所有失败请求的示例：

🌐 Example of logging of all the failed requests:

page.on("requestfailed", lambda request: print(request.url + " " + request.failure))

NoneType | str #

frame

Added before v1.9

request.frame

返回发起此请求的 Frame。

🌐 Returns the Frame that initiated this request.

用法

frame_url = request.frame.url

Frame #

详情

请注意，在某些情况下，框架不可用，此方法将抛出异常。

🌐 Note that in some cases the frame is not available, and this method will throw.

当请求源自服务工作者时。你可以使用 request.serviceWorker() 来检查这一点。
当导航请求在对应帧创建前发出时。你可以用 [request.is_navigation_request（）]（/api/class-request.mdx#request-is-navigation-request）来检查。

这是一个处理所有情况的示例：

🌐 Here is an example that handles all the cases:

headers

Added before v1.9

request.headers

一个包含请求 HTTP 头的对象。头名称为小写。请注意，此方法不会返回与安全相关的头，包括与 cookie 相关的头。你可以使用 request.all_headers() 获取包含 cookie 信息的完整头列表。

🌐 An object with the request HTTP headers. The header names are lower-cased. Note that this method does not return security-related headers, including cookie-related ones. You can use request.all_headers() for complete list of headers that include cookie information.

用法

request.headers

Dict[str, str]#

Added before v1.9

request.is_navigation_request

该请求是否驱动框架的导航。

🌐 Whether this request is driving frame's navigation.

有些导航请求是在对应的帧被创建之前发出的，因此没有可用的 request.frame。

🌐 Some navigation requests are issued before the corresponding frame is created, and therefore do not have request.frame available.

用法

request.is_navigation_request()

bool #

method

Added before v1.9

request.method

请求的方法（GET、POST 等）

🌐 Request's method (GET, POST, etc.)

用法

request.method

str #

post_data

Added before v1.9

request.post_data

请求的帖子正文（如果有）。

🌐 Request's post body, if any.

用法

request.post_data

NoneType | str #

post_data_buffer

Added before v1.9

request.post_data_buffer

二进制形式的请求的帖子正文（如果有）。

🌐 Request's post body in a binary form, if any.

用法

request.post_data_buffer

NoneType | bytes #

post_data_json

Added before v1.9

request.post_data_json

返回解析后的 form-urlencoded 请求体，如果有则以 JSON 作为备用。

🌐 Returns parsed request's body for form-urlencoded and JSON as a fallback if any.

当响应为 application/x-www-form-urlencoded 时，将返回一个包含这些值的键/值对象。否则，它将被解析为 JSON。

🌐 When the response is application/x-www-form-urlencoded then a key/value object of the values will be returned. Otherwise it will be parsed as JSON.

用法

request.post_data_json

NoneType | Dict #

redirected_from

Added before v1.9

request.redirected_from

服务器重定向到此请求的请求（如果有）。

🌐 Request that was redirected by the server to this one, if any.

当服务器响应重定向时，Playwright 会创建一个新的 Request 对象。这两个请求通过 redirectedFrom() 和 redirectedTo() 方法连接。当发生多个服务器重定向时，可以通过反复调用 redirectedFrom() 来构建整个重定向链。

🌐 When the server responds with a redirect, Playwright creates a new Request object. The two requests are connected by redirectedFrom() and redirectedTo() methods. When multiple server redirects has happened, it is possible to construct the whole redirect chain by repeatedly calling redirectedFrom().

用法

例如，如果网站 http://example.com 重定向到 https://example.com：

🌐 For example, if the website http://example.com redirects to https://example.com:

Sync
Async

response = page.goto("http://example.com")
print(response.request.redirected_from.url) # "http://example.com"

response = await page.goto("http://example.com")
print(response.request.redirected_from.url) # "http://example.com"

如果网站 https://google.com 没有重定向：

🌐 If the website https://google.com has no redirects:

Sync
Async

response = page.goto("https://google.com")
print(response.request.redirected_from) # None

response = await page.goto("https://google.com")
print(response.request.redirected_from) # None

NoneType | Request #

redirected_to

Added before v1.9

request.redirected_to

如果服务器以重定向响应，则浏览器触发新请求。

🌐 New request issued by the browser if the server responded with redirect.

用法

这个方法与 request.redirected_from 相反：

🌐 This method is the opposite of request.redirected_from:

assert request.redirected_from.redirected_to == request

NoneType | Request #

resource_type

Added before v1.9

request.resource_type

包含渲染引擎感知到的请求的资源类型。ResourceType 将是以下之一：document、stylesheet、image、media、font、script、texttrack、xhr、fetch、eventsource、websocket、manifest、other。

🌐 Contains the request's resource type as it was perceived by the rendering engine. ResourceType will be one of the following: document, stylesheet, image, media, font, script, texttrack, xhr, fetch, eventsource, websocket, manifest, other.

用法

request.resource_type

str #

service_worker

Added in: v1.24

request.service_worker

执行请求的服务工作进程。

🌐 The Service Worker that is performing the request.

用法

request.service_worker

NoneType | Worker #

详情

此方法仅适用于 Chromium。使用其他浏览器时调用也是安全的，但它将始终返回 null。

🌐 This method is Chromium only. It's safe to call when using other browsers, but it will always be null.

由服务工作进程发起的请求没有可用的 request.frame 。

🌐 Requests originated in a Service Worker do not have a request.frame available.

timing

Added before v1.9

request.timing

返回给定请求的资源计时信息。大多数计时值在响应时可用，responseEnd 在请求完成时可用。更多信息请参见资源计时 API。

🌐 Returns resource timing information for given request. Most of the timing values become available upon the response, responseEnd becomes available when request finishes. Find more information at Resource Timing API.

用法

Sync
Async

with page.expect_event("requestfinished") as request_info:
    page.goto("http://example.com")
request = request_info.value
print(request.timing)

async with page.expect_event("requestfinished") as request_info:
    await page.goto("http://example.com")
request = await request_info.value
print(request.timing)

Dict#
- startTime float
  
  自 1970 年 1 月 1 日 00:00:00 UTC 以来经过的请求开始时间（以毫秒为单位）
- domainLookupStart float
  
  浏览器开始为资源进行域名查找之前的时间。该值以相对于 startTime 的毫秒为单位，如果不可用则为 -1。
- domainLookupEnd float
  
  浏览器启动后立即进行资源的域名查找的时间。该值以相对于 startTime 的毫秒为单位给出，如果不可用则为 -1。
- connectStart float
  
  用户代理开始建立与服务器的连接以获取资源之前的时间。该值以相对于 startTime 的毫秒为单位，如果不可用则为 -1。
- secureConnectionStart float
  
  浏览器开始握手过程以保护当前连接之前的时间。该值以相对于 startTime 的毫秒为单位给出，如果不可用则为 -1。
- connectEnd float
  
  用户代理开始建立与服务器的连接以获取资源之前的时间。该值以相对于 startTime 的毫秒为单位，如果不可用则为 -1。
- requestStart float
  
  浏览器开始从服务器、缓存或本地资源请求资源之前的时间。该值以相对于 startTime 的毫秒为单位表示，如果不可用则为 -1。
- responseStart float
  
  浏览器从服务器、缓存或本地资源接收响应的第一个字节后立即使用时间。该值以毫秒为单位，相对于“startTime”，如果无法获得则为-1。
- responseEnd float
  
  在浏览器接收到资源的最后一个字节之后或传输连接关闭之前（以先发生者为准）的时间。该值以相对于 startTime 的毫秒为单位表示，如果不可用则为 -1。

url

Added before v1.9

request.url

请求的 URL。

🌐 URL of the request.

用法

request.url

str #

方法​

all_headers​

header_value​

headers_array​

response​

sizes​

属性​

failure​

frame​

headers​

is_navigation_request​

method​

post_data​

post_data_buffer​

post_data_json​

redirected_from​

redirected_to​

resource_type​

service_worker​

timing​

url​

方法

all_headers

header_value

headers_array

response

sizes

属性

failure

frame

headers

is_navigation_request

method

post_data

post_data_buffer

post_data_json

redirected_from

redirected_to

resource_type

service_worker

timing

url