跳到主要内容

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 (可选)

      证书颁发者字段的通用名称（Common Name）部分。仅供参考。可选。

    • protocol str (可选)

      使用的具体 TLS 协议（例如 TLS 1.3）。可选。

    • subjectName str (可选)

      证书主题字段的通用名称（Common Name）部分。仅供参考。可选。

    • 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

指示该响应是否由 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

返回值