跳到主要内容

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​

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。

用法

await response.headerValue(name);

参数

返回值

headerValues​

Added in: v1.15 response.headerValues

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

用法

await response.headerValues(name);

参数

返回值

headers​

Added before v1.9 response.headers

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

用法

response.headers();

返回值

headersArray​

Added in: v1.15 response.headersArray

包含与此响应关联的所有请求 HTTP 头信息的数组。与 response.allHeaders() 不同，此方法不会将头名称转为小写。对于具有多个条目（如 Set-Cookie）的头部，会在数组中多次出现。

用法

await response.headersArray();

返回值

json​

Added before v1.9 response.json

返回响应体的 JSON 表示形式。

如果响应体无法通过 JSON.parse 解析，此方法将抛出异常。

用法

await response.json();

返回值

ok​

Added before 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 (可选)

      证书颁发者字段的通用名称组件。仅用于信息参考。可选。

    • protocol string (可选)

      使用的具体 TLS 协议（例如 TLS 1.3）。可选。

    • subjectName string (可选)

      证书主题字段的通用名称组件。仅用于信息参考。可选。

    • validFrom number (可选)

      证书生效的 Unix 时间戳（秒）。可选。

    • validTo number (可选)

      证书失效的 Unix 时间戳（秒）。可选。

serverAddr​

Added in: v1.13 response.serverAddr

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

用法

await response.serverAddr();

返回值

status​

Added before v1.9 response.status

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

用法

response.status();

返回值

statusText​

Added before v1.9 response.statusText

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

用法

response.statusText();

返回值

text​

Added before v1.9 response.text

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

用法

await response.text();

返回值

url​

v1.9 之前版本添加 response.url

包含响应的 URL。

用法

response.url();

返回值