跳到主要内容

Response

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

方法​

AllHeadersAsync​

添加于：v1.15 response.AllHeadersAsync

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

用法

await Response.AllHeadersAsync();

返回值

BodyAsync​

在 v1.9 之前添加 response.BodyAsync

返回包含响应正文的缓冲区。

用法

await Response.BodyAsync();

返回值

FinishedAsync​

在 v1.9 之前添加 response.FinishedAsync

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

用法

await Response.FinishedAsync();

返回值

Frame​

在 v1.9 之前添加 response.Frame

返回发起此响应的 Frame。

用法

Response.Frame

返回值

FromServiceWorker​

新增于：v1.23 response.FromServiceWorker

指示此 Response 是否由服务工作线程（Service Worker）的 Fetch 处理器（即通过 FetchEvent.respondWith）完成。

用法

Response.FromServiceWorker

返回值

HeaderValueAsync​

新增于：v1.15 response.HeaderValueAsync

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

用法

await Response.HeaderValueAsync(name);

参数

返回值

HeaderValuesAsync​

新增于：v1.15 response.HeaderValuesAsync

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

用法

await Response.HeaderValuesAsync(name);

参数

返回值

Headers​

在 v1.9 之前添加 response.Headers

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

用法

Response.Headers

返回值

HeadersArrayAsync​

添加于：v1.15 response.HeadersArrayAsync

与该响应关联的所有请求 HTTP 标头组成的数组。与 Response.AllHeadersAsync() 不同，标头名称不会转换为小写形式。具有多个条目的标头（如 Set-Cookie）会在数组中多次出现。

用法

await Response.HeadersArrayAsync();

返回值

JsonAsync​

在 v1.9 之前添加 response.JsonAsync

返回响应正文的 JSON 表示形式。

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

用法

await Response.JsonAsync();

返回值

Ok​

在 v1.9 之前添加 response.Ok

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

用法

Response.Ok

返回值

Request​

在 v1.9 之前添加 response.Request

返回匹配的 Request 对象。

用法

Response.Request

返回值

SecurityDetailsAsync​

添加于：v1.13 response.SecurityDetailsAsync

返回 SSL 和其他安全信息。

用法​

await Response.SecurityDetailsAsync();

返回值​

  • SecurityDetails?#

    • issuer string?（可选）

      证书颁发者字段中的公用名组件。此信息仅用于参考目的。可选。

    • protocol string?（可选）

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

    • subjectName string?（可选）

      证书主题字段中的公用名组件。此信息仅用于参考目的。可选。

    • validFrom [float]?（可选）

      此证书生效的 Unix 时间戳（以秒为单位）。可选。

    • validTo [float]?（可选）

      此证书失效的 Unix 时间戳（以秒为单位）。可选。

ServerAddrAsync​

添加于：v1.13 response.ServerAddrAsync

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

用法​

await Response.ServerAddrAsync();

返回值​

  • ServerAddr?#

    • ipAddress string

      服务器的 IPv4 或 IPV6 地址。

    • port int

Status​

在 v1.9 之前添加 response.Status

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

用法​

Response.Status

返回值​

StatusText​

在 v1.9 之前添加 response.StatusText

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

用法

Response.StatusText

返回值

TextAsync​

在 v1.9 之前添加 response.TextAsync

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

用法

await Response.TextAsync();

返回值

Url​

在 v1.9 之前添加 response.Url

包含响应的 URL。

用法

Response.Url

返回值