Skip to main content

Response

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

response.all_headers()​

Added in: v1.15

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

response.body()​

Added in: v1.8

返回包含响应正文的缓冲区。

response.finished()​

Added in: v1.8

等待该响应完成，总是返回 null。

response.frame​

Added in: v1.8

返回发起该响应的 Frame。

response.from_service_worker​

Added in: v1.23

指示该响应是否由 Service Worker 的 Fetch 处理程序完成（即通过 FetchEvent.respondWith）。

response.header_value(name)​

Added in: v1.15

返回与名称匹配的标头值。名称不区分大小写。如果存在多个同名标头（set-cookie 除外），会以 , 分隔的列表返回；对于 set-cookie，会使用 \n 分隔符。若未找到标头，则返回 null。

response.header_values(name)​

Added in: v1.15

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

response.headers​

Added in: v1.8

包含响应 HTTP 头的对象，头名称均为小写。注意该方法不会返回安全相关的头（包括 cookie 相关内容），若需要包含 cookie 信息的完整头列表，请使用 response.all_headers()。

response.headers_array()​

Added in: v1.15

包含与该响应关联的所有请求 HTTP 头的数组。与 response.all_headers() 不同，这里的头名称不会转换成小写。对于 Set-Cookie 等包含多个条目的头，会在数组中出现多次。

response.json()​

Added in: v1.8

返回响应正文的 JSON 表示。 如果响应正文无法通过 JSON.parse 解析，则会抛出异常。

response.ok​

Added in: v1.8

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

response.request​

Added in: v1.8

返回匹配的 Request 对象。

response.security_details()​

Added in: v1.13
  • returns: <NoneType|Dict>#
    • issuer <str> 证书颁发者字段中的通用名称部分，仅供信息参考，可选。
    • protocol <str> 使用的 TLS 协议（例如 TLS 1.3），可选。
    • subjectName <str> 证书主题字段中的通用名称部分，仅供信息参考，可选。
    • validFrom <float> 证书生效时间的 Unix 时间戳（秒），可选。
    • validTo <float> 证书失效时间的 Unix 时间戳（秒），可选。

返回 SSL 及其他安全信息。

response.server_addr()​

Added in: v1.13
  • returns: <NoneType|Dict>#
    • ipAddress <str> 服务器的 IPv4 或 IPv6 地址。
    • port <int> 服务器端口。

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

response.status​

Added in: v1.8

包含响应的状态码（例如 200 代表成功）。

response.status_text​

Added in: v1.8

包含响应的状态文本（例如常见的 “OK” 表示成功）。

response.text()​

Added in: v1.8

返回响应正文的文本表示。

response.url​

Added in: v1.8

包含响应的 URL。