跳至主要内容

响应

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

指示此响应是否由服务工作者的获取处理程序（即通过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 | 对象>#

    • issuer 字符串 (可选)

      证书中颁发者字段的公用名组件。仅应出于信息目的使用。可选。

    • protocol 字符串 (可选)

      使用的特定 TLS 协议。（例如TLS 1.3）。可选。

    • subjectName 字符串 (可选)

      证书中主题字段的公用名组件。仅应出于信息目的使用。可选。

    • validFrom 数字 (可选)

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

    • validTo 数字 (可选)

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

返回值