跳到主要内容

Response

Response 类表示页面接收到的响应。

方法​

all_headers​

新增于: v1.15 response.all_headers

一个对象，包含与此响应关联的所有响应 HTTP 标头。

用法

response.all_headers()

返回

body​

v1.9 之前新增 response.body

返回包含响应主体的缓冲区。

用法

response.body()

返回

finished​

v1.9 之前新增 response.finished

等待此响应完成，始终返回 null。

用法

response.finished()

返回

header_value​

新增于: v1.15 response.header_value

返回与名称匹配的标头值。名称不区分大小写。如果多个标头具有相同的名称（除了 set-cookie），它们将以 , 分隔的列表形式返回。对于 set-cookie，使用 \n 分隔符。如果找不到标头，则返回 null。

用法

response.header_value(name)

参数

  • name str#

    标头名称。

返回

header_values​

新增于: v1.15 response.header_values

返回与名称匹配的所有标头值，例如 set-cookie。名称不区分大小写。

用法

response.header_values(name)

参数

  • name str#

    标头名称。

返回

headers_array​

新增于: v1.15 response.headers_array

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

用法

response.headers_array()

返回

json​

v1.9 之前新增 response.json

返回响应主体的 JSON 表示。

如果响应主体无法通过 JSON.parse 进行解析，此方法将抛出异常。

用法

response.json()

返回

security_details​

新增于: v1.13 response.security_details

返回 SSL 和其他安全信息。

用法

response.security_details()

返回

  • NoneType | Dict#

    • issuer str (可选)

      证书中颁发者（Issuer）字段的通用名称组件。此信息仅供参考。可选。

    • protocol str (可选)

      使用的特定 TLS 协议。（例如 TLS 1.3）。可选。

    • subjectName str (可选)

      证书中主题（Subject）字段的通用名称组件。此信息仅供参考。可选。

    • validFrom float (可选)

      指定此证书何时生效的 Unix 时间戳（以秒为单位）。可选。

    • validTo float (可选)

      指定此证书何时失效的 Unix 时间戳（以秒为单位）。可选。

server_addr​

新增于: v1.13 response.server_addr

返回服务器的 IP 地址和端口。

用法

response.server_addr()

返回

text​

v1.9 之前新增 response.text

返回响应主体的文本表示。

用法

response.text()

返回

属性​

frame​

v1.9 之前新增 response.frame

返回发起此响应的 Frame 对象。

用法

response.frame

返回

from_service_worker​

新增于: v1.23 response.from_service_worker

指示此 Response 是否由 Service Worker 的 Fetch Handler（即通过 FetchEvent.respondWith）完成。

用法

response.from_service_worker

返回

headers​

v1.9 之前新增 response.headers

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

用法

response.headers

返回

ok​

v1.9 之前新增 response.ok

包含一个布尔值，指示响应是否成功（状态码在 200-299 范围内）。

用法

response.ok

返回

request​

v1.9 之前新增 response.request

返回匹配的 Request 对象。

用法

response.request

返回

status​

v1.9 之前新增 response.status

包含响应的状态码（例如，成功时为 200）。

用法

response.status

返回

status_text​

v1.9 之前新增 response.status_text

包含响应的状态文本（例如，成功时通常为“OK”）。

用法

response.status_text

返回

url​

v1.9 之前新增 response.url

包含响应的 URL。

用法

response.url

返回