跳到主要内容

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

指示此 Response 是否由 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 字段的 Common Name 组件。仅用于信息目的。可选。

    • protocol String (可选)

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

    • subjectName String (可选)

      证书 Subject 字段的 Common Name 组件。仅用于信息目的。可选。

    • 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();

返回值