跳转到主要内容

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

指示此响应是否由 Service Worker 的 Fetch Handler 满足(即通过 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? (可选)

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

    • protocol string? (可选)

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

    • subjectName string? (可选)

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

    • 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

返回