响应

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

方法​

allHeaders​

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

用法

await response.allHeaders();

返回

• Promise<Object<string, string>>#

正文​

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

用法

await response.body();

返回

• Promise<Buffer>#

已完成​

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

用法

await response.finished();

返回

• Promise<null | Error>#

框架​

返回发起此响应的Frame。

用法

response.frame();

返回

• Frame#

来自ServiceWorker​

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

用法

response.fromServiceWorker();

返回

• boolean#

headerValue​

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

用法

await response.headerValue(name);

参数

• name string#

  标头的名称。

返回

• Promise<null | string>#

headerValues​

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

用法

await response.headerValues(name);

参数

• name string#

  请求头的名称。

返回

• Promise<Array<string>>#

headers​

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

用法

response.headers();

返回

• Object<string, string>#

headersArray​

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

用法

await response.headersArray();

返回

• Promise<数组<Object>>#

  • name string

    标头的名称。

  • value string

    标头的值。

json​

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

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

用法

await response.json();

返回

• Promise<Serializable>#

好的​

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

用法

response.ok();

返回

• boolean#

请求​

返回匹配的Request对象。

用法

response.request();

返回

• Request#

securityDetails​

返回SSL和其他安全信息。

用法

await response.securityDetails();

返回

• Promise<null | Object>#

  • issuer string (可选)

    证书中Issuer字段的Common Name组件。这仅应用于提供信息。可选。

  • protocol string (可选)

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

  • subjectName string (可选)

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

  • validFrom number (可选)

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

  • validTo number (可选)

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

服务器地址​

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

用法

await response.serverAddr();

返回

• Promise<null | Object>#

  • ipAddress string

    服务器的IPv4或IPV6地址。

  • port number

状态​

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

用法

response.status();

返回

• number#

状态文本​

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

用法

response.statusText();

返回

• string#

文本​

返回响应体的文本表示。

用法

await response.text();

返回

• Promise<string>#

网址​

包含响应的URL。

用法

response.url();

返回

• string#