Skip to main content

Response

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

response.allHeaders()​

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.fromServiceWorker()​

Added in: v1.23

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

response.headerValue(name)​

Added in: v1.15

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

response.headerValues(name)​

Added in: v1.15

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

response.headers()​

Added in: v1.8

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

response.headersArray()​

Added in: v1.15

包含与此响应关联的所有请求 HTTP 标头的数组。与 response.allHeaders() 不同，标头名称不是小写的。具有多个条目的标头（例如 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.securityDetails()​

Added in: v1.13
  • returns: <Promise<null|Object>>#
    • issuer? <string> 证书中颁发者字段的通用名称组件。这仅应用于提供信息。可选。
    • protocol? <string> 使用的特定 TLS 协议。（例如 TLS 1.3）。可选。
    • subjectName? <string> 证书中主题字段的通用名称组件。这仅应用于提供信息。可选。
    • validFrom? <number> 指定此证书何时生效的 Unix 时间戳（以秒为单位）。可选。
    • validTo? <number> 指定此证书何时失效的 Unix 时间戳（以秒为单位）。可选。

返回 SSL 和其他安全信息。

response.serverAddr()​

Added in: v1.13

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

response.status()​

Added in: v1.8

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

response.statusText()​

Added in: v1.8

包含响应的状态文本（例如，通常 "OK" 表示成功）。

response.text()​

Added in: v1.8

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

response.url()​

Added in: v1.8

包含响应的 URL。