WebResource interface

要向远程服务器发出的 HTTP 请求的说明。

属性

abortSignal

中止控制器的信号。 可用于中止发送网络请求和等待响应。

agent

仅 NODEJS

用于提供自定义 http.Agent/https.Agent的仅限节点的选项。 注意:通常,这应该是多个请求共享的一个实例,以便重复使用与服务的基础连接。 在浏览器中运行时不执行任何作。

body

请求的 HTTP 正文内容。

decompressResponse

是否根据 Accept-Encoding 标头(仅节点提取)解压缩响应

formData

表单数据,用于生成请求正文。

headers

发出请求时要使用的 HTTP 标头。

keepAlive

如果应重复使用连接。

method

发出请求时要使用的 HTTP 方法。

onDownloadProgress

下载进度触发的回调。

onUploadProgress

上传进度时触发的回调。

proxySettings

代理配置。

query

表示为对象的查询字符串。

requestId

请求的唯一标识符。 用于日志记录和跟踪。

requestOverrides

要在请求上设置的其他选项。 这提供了一种覆盖现有属性或提供未声明的请求属性的方法。

有关可能的有效属性,请参阅

警告:当请求由 IHttpClient发送时,此处指定的选项将覆盖任何同名属性。

streamResponseBody

是否应将 HttpOperationResponse 的正文视为流。

streamResponseStatusCodes

响应状态代码的列表,其相应的 HttpOperationResponse 正文应被视为流。

timeout

请求在自动终止之前可能需要的毫秒数。 如果请求终止,则会引发 AbortError

url

请求访问的 URL。

withCredentials

如果在 XHR 期间应发送凭据(Cookie)。

方法

clone()

克隆此请求对象。

prepare(unknown)

这是出于兼容性目的 no-op,如果调用,将引发。

validateRequestProperties()

验证是否定义了所需的属性,例如方法、url、headers[“Content-Type”]、headers[“accept-language”] 。 如果未定义上述属性之一,则会引发错误。 注意:这是出于兼容性目的的 no-op。

属性详细信息

abortSignal

中止控制器的信号。 可用于中止发送网络请求和等待响应。

abortSignal?: AbortSignalLike

属性值

agent

仅 NODEJS

用于提供自定义 http.Agent/https.Agent的仅限节点的选项。 注意:通常,这应该是多个请求共享的一个实例,以便重复使用与服务的基础连接。 在浏览器中运行时不执行任何作。

agent?: Agent

属性值

body

请求的 HTTP 正文内容。

body?: any

属性值

any

decompressResponse

是否根据 Accept-Encoding 标头(仅节点提取)解压缩响应

decompressResponse?: boolean

属性值

boolean

formData

表单数据,用于生成请求正文。

formData?: any

属性值

any

headers

发出请求时要使用的 HTTP 标头。

headers: HttpHeadersLike

属性值

keepAlive

如果应重复使用连接。

keepAlive?: boolean

属性值

boolean

method

发出请求时要使用的 HTTP 方法。

method: HttpMethods

属性值

onDownloadProgress

下载进度触发的回调。

onDownloadProgress?: (progress: TransferProgressEvent) => void

属性值

(progress: TransferProgressEvent) => void

onUploadProgress

上传进度时触发的回调。

onUploadProgress?: (progress: TransferProgressEvent) => void

属性值

(progress: TransferProgressEvent) => void

proxySettings

代理配置。

proxySettings?: ProxySettings

属性值

query

表示为对象的查询字符串。

query?: {[key: string]: any}

属性值

{[key: string]: any}

requestId

请求的唯一标识符。 用于日志记录和跟踪。

requestId: string

属性值

string

requestOverrides

要在请求上设置的其他选项。 这提供了一种覆盖现有属性或提供未声明的请求属性的方法。

有关可能的有效属性,请参阅

警告:当请求由 IHttpClient发送时,此处指定的选项将覆盖任何同名属性。

requestOverrides?: Record<string, unknown>

属性值

Record<string, unknown>

streamResponseBody

警告

现已弃用此 API。

Use streamResponseStatusCodes property instead.

是否应将 HttpOperationResponse 的正文视为流。

streamResponseBody?: boolean

属性值

boolean

streamResponseStatusCodes

响应状态代码的列表,其相应的 HttpOperationResponse 正文应被视为流。

streamResponseStatusCodes?: Set<number>

属性值

Set<number>

timeout

请求在自动终止之前可能需要的毫秒数。 如果请求终止,则会引发 AbortError

timeout: number

属性值

number

url

请求访问的 URL。

url: string

属性值

string

withCredentials

如果在 XHR 期间应发送凭据(Cookie)。

withCredentials: boolean

属性值

boolean

方法详细信息

clone()

克隆此请求对象。

function clone(): WebResourceLike

返回

prepare(unknown)

这是出于兼容性目的 no-op,如果调用,将引发。

function prepare(options: unknown): WebResourceLike

参数

options

unknown

返回

validateRequestProperties()

验证是否定义了所需的属性,例如方法、url、headers[“Content-Type”]、headers[“accept-language”] 。 如果未定义上述属性之一,则会引发错误。 注意:这是出于兼容性目的的 no-op。

function validateRequestProperties()