跳至主要内容

响应

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


方法

allHeaders

Added in: v1.15 response.allHeaders

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

用法

Response.allHeaders();

返回


正文

Added before v1.9 response.body

返回包含响应体的缓冲区。

用法

Response.body();

返回


已完成

Added before v1.9 response.finished

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

用法

Response.finished();

返回


框架

Added before v1.9 response.frame

返回发起此响应的Frame

用法

Response.frame();

返回


来自ServiceWorker

Added in: v1.23 response.fromServiceWorker

指示此Response是否由Service Worker的Fetch Handler(即通过FetchEvent.respondWith)完成。

用法

Response.fromServiceWorker();

返回


headerValue

Added in: v1.15 response.headerValue

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

用法

Response.headerValue(name);

参数

  • name String#

    请求头的名称。

返回


headerValues

Added in: v1.15 response.headerValues

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

用法

Response.headerValues(name);

参数

返回


headers

Added before v1.9 response.headers

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

用法

Response.headers();

返回


headersArray

Added in: v1.15 response.headersArray

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

用法

Response.headersArray();

返回


好的

Added before v1.9 response.ok

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

用法

Response.ok();

返回


请求

Added before v1.9 response.request

返回匹配的Request对象。

用法

Response.request();

返回


securityDetails

Added in: v1.13 response.securityDetails

返回SSL和其他安全信息。

用法

Response.securityDetails();

返回

  • null | SecurityDetails#
    • issuer String (可选)

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

    • protocol String (可选)

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

    • subjectName String (可选)

      证书中Subject字段的通用名称(Common Name)组件。该字段仅用于提供参考信息,属于可选参数。

    • validFrom double (可选)

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

    • validTo double (可选)

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


服务器地址

Added in: v1.13 response.serverAddr

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

用法

Response.serverAddr();

返回

  • null | ServerAddr#
    • ipAddress String

      服务器的IPv4或IPv6地址。

    • port int


状态

Added before v1.9 response.status

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

用法

Response.status();

返回


状态文本

Added before v1.9 response.statusText

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

用法

Response.statusText();

返回


文本

Added before v1.9 response.text

返回响应体的文本表示。

用法

Response.text();

返回


网址

Added before v1.9 response.url

包含响应的URL。

用法

Response.url();

返回