你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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

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

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

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