跳转到主要内容

Response

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

方法​

allHeaders​

新增于: v1.15 response.allHeaders

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

用法

Response.allHeaders();

返回

body​

v1.9 之前添加 response.body

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

用法

Response.body();

返回

finished​

v1.9 之前添加 response.finished

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

用法

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`。

用法

Response.headerValue(name);

参数

返回

headerValues​

新增于: v1.15 response.headerValues

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

用法

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`，在数组中会出现多次。

用法

Response.headersArray();

返回

ok​

v1.9 之前添加 response.ok

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

用法

Response.ok();

返回

request​

v1.9 之前添加 response.request

返回匹配的 Request 对象。

用法

Response.request();

返回

securityDetails​

添加于：v1.13 response.securityDetails

返回 SSL 和其他安全信息。

用法

Response.securityDetails();

返回

  • null | SecurityDetails#

    • issuer String （可选）

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

    • protocol String （可选）

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

    • subjectName String （可选）

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

    • validFrom double （可选）

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

    • validTo double （可选）

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

serverAddr​

添加于：v1.13 response.serverAddr

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

用法

Response.serverAddr();

返回

  • null | ServerAddr#

    • ipAddress String

      服务器的 IPv4 或 IPv6 地址。

    • port int

status​

v1.9 之前添加 response.status

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

用法

Response.status();

返回

statusText​

v1.9 之前添加 response.statusText

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

用法

Response.statusText();

返回

text​

v1.9 之前添加 response.text

返回响应体的文本表示。

用法

Response.text();

返回

url​

v1.9 之前添加 response.url

包含响应的 URL。

用法

Response.url();

返回