跳转到主要内容

Response

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


方法

allHeaders

新增于: v1.15 response.allHeaders

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

用法

await response.allHeaders();

返回


body

v1.9 之前添加 response.body

返回带有响应体的缓冲区。

用法

await response.body();

返回


finished

v1.9 之前添加 response.finished

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

用法

await response.finished();

返回


frame

v1.9 之前添加 response.frame

返回发起此响应的 Frame

用法

response.frame();

返回


fromServiceWorker

添加于:v1.23 response.fromServiceWorker

指示此响应是否由 Service Worker 的 Fetch Handler 满足(即通过 FetchEvent.respondWith)。

用法

response.fromServiceWorker();

返回


headerValue

新增于: v1.15 response.headerValue

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

用法

await response.headerValue(name);

参数

返回


headerValues

新增于: v1.15 response.headerValues

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

用法

await response.headerValues(name);

参数

返回


headers

v1.9 之前添加 response.headers

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

用法

response.headers();

返回


headersArray

新增于: v1.15 response.headersArray

一个包含与此响应相关联的所有请求 HTTP 头部的数组。与 response.allHeaders() 不同,头部名称不小写。具有多个条目的头部,例如 Set-Cookie,会在数组中出现多次。

用法

await response.headersArray();

返回


json

v1.9 之前添加 response.json

返回响应体的 JSON 表示。

如果响应体无法通过 JSON.parse 解析,此方法将抛出错误。

用法

await response.json();

返回


ok

v1.9 之前添加 response.ok

包含一个布尔值,表示响应是否成功(状态码在 200-299 范围内)。

用法

response.ok();

返回


request

v1.9 之前添加 response.request

返回匹配的 Request 对象。

用法

response.request();

返回


securityDetails

添加于:v1.13 response.securityDetails

返回 SSL 和其他安全信息。

用法

await response.securityDetails();

返回

  • Promise<null | Object>#
    • issuer string (可选)

      证书中 Issuer 字段的通用名称组件。这仅用于信息目的。可选。

    • protocol string (可选)

      使用的特定 TLS 协议。(例如 TLS 1.3)。可选。

    • subjectName string (可选)

      证书中 Subject 字段的通用名称组件。这仅用于信息目的。可选。

    • validFrom number (可选)

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

    • validTo number (可选)

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


serverAddr

添加于:v1.13 response.serverAddr

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

用法

await response.serverAddr();

返回


status

v1.9 之前添加 response.status

包含响应的状态码(例如,成功时为 200)。

用法

response.status();

返回


statusText

v1.9 之前添加 response.statusText

包含响应的状态文本(例如,成功时通常为 "OK")。

用法

response.statusText();

返回


text

v1.9 之前添加 response.text

返回响应体的文本表示。

用法

await response.text();

返回


url

v1.9 之前添加 response.url

包含响应的 URL。

用法

response.url();

返回