WebResource class

Пакет:

@azure/core-http

Создает новый объект WebResource.

Этот класс предоставляет абстракцию по вызову REST, будучи библиотекой или реализацией неактивным и упаковав необходимые свойства для запуска запроса.

Конструкторы

WebResource(string, HttpMethods, unknown, {[key: string]: any}, {[key: string]: any} | HttpHeadersLike, boolean, boolean, AbortSignalLike, number, (progress: TransferProgressEvent) => void, (progress: TransferProgressEvent) => void, ProxySettings, boolean, boolean, Set<number>)

Свойства

abortSignal	Сигнал контроллера прерывания. Можно использовать для прерывания отправки сетевого запроса и ожидания ответа.
body	Текст запроса.
decompressResponse	Следует ли декомпрессировать ответ в соответствии с заголовком Accept-Encoding (только узел-извлечение)
formData	Данные формы, используемые для создания текста запроса.
headers	Заголовки HTTP.
keepAlive	Следует ли сохранять http-подключения в живых во всех запросах.
method	Метод HTTP для использования.
onDownloadProgress	Обратный вызов, который запускается при выполнении скачивания.
onUploadProgress	Обратный вызов, который запускается при выполнении отправки.
operationResponseGetter	Функция, возвращающая правильное сочетание OperationResponse для заданной комбинации OperationSpec и HttpOperationResponse. Если это не определено, будет использоваться простой поиск кода состояния.
operationSpec	Спецификация HTTP-запроса.
proxySettings	Какой прокси-сервер следует использовать при необходимости.
query	Запрос, добавленный в URL-адрес.
requestId	Уникальный идентификатор исходящего запроса.
shouldDeserialize	Следует ли десериализировать httpOperationResponse. Если это не определено, необходимо десериализировать httpOperationResponse.
spanOptions	Трассировка: параметры, используемые для создания диапазона при включении трассировки.
streamResponseBody	Следует ли рассматривать текст httpOperationResponse как поток.
streamResponseStatusCodes	Список кодов состояния, соответствующий текст HttpOperationResponse, должен рассматриваться как поток.
timeout	Как долго ждать в миллисекундах перед прерыванием запроса.
tracingContext	Трассировка: контекст, используемый при создании диапазонов.
url	URL-адрес исходящего запроса.
withCredentials	Следует ли отправлять учетные данные (с помощью файлов cookie, заголовков авторизации или сертификатов клиента TLS) при выполнении запроса в браузере в место назначения между сайтами.

Методы

clone()	Клонируйте этот объект HTTP-запроса WebResource.
prepare(RequestPrepareOptions)	Подготавливает запрос.
validateRequestProperties()	Проверяет, определены ли обязательные свойства, такие как метод, URL-адрес, заголовки["Content-Type"], заголовки["accept-language"]. Это приведет к ошибке, если одно из указанных выше свойств не определено.

Сведения о конструкторе

WebResource(string, HttpMethods, unknown, {[key: string]: any}, {[key: string]: any} | HttpHeadersLike, boolean, boolean, AbortSignalLike, number, (progress: TransferProgressEvent) => void, (progress: TransferProgressEvent) => void, ProxySettings, boolean, boolean, Set<number>)

new WebResource(url?: string, method?: HttpMethods, body?: unknown, query?: {[key: string]: any}, headers?: {[key: string]: any} | HttpHeadersLike, streamResponseBody?: boolean, withCredentials?: boolean, abortSignal?: AbortSignalLike, timeout?: number, onUploadProgress?: (progress: TransferProgressEvent) => void, onDownloadProgress?: (progress: TransferProgressEvent) => void, proxySettings?: ProxySettings, keepAlive?: boolean, decompressResponse?: boolean, streamResponseStatusCodes?: Set<number>)

Параметры

url

string

method

HttpMethods

body

unknown

query

{[key: string]: any}

headers

{[key: string]: any} | HttpHeadersLike

streamResponseBody

boolean

withCredentials

boolean

abortSignal

AbortSignalLike

timeout

number

onUploadProgress

(progress: TransferProgressEvent) => void

onDownloadProgress

(progress: TransferProgressEvent) => void

proxySettings

ProxySettings

keepAlive

boolean

decompressResponse

boolean

streamResponseStatusCodes

Set<number>

Сведения о свойстве

abortSignal

Сигнал контроллера прерывания. Можно использовать для прерывания отправки сетевого запроса и ожидания ответа.

abortSignal?: AbortSignalLike

Значение свойства

AbortSignalLike

body

Текст запроса.

body?: any

Значение свойства

any

decompressResponse

Следует ли декомпрессировать ответ в соответствии с заголовком Accept-Encoding (только узел-извлечение)

decompressResponse?: boolean

Значение свойства

boolean

formData

Данные формы, используемые для создания текста запроса.

formData?: any

Значение свойства

any

headers

Заголовки HTTP.

headers: HttpHeadersLike

Значение свойства

HttpHeadersLike

keepAlive

Следует ли сохранять http-подключения в живых во всех запросах.

keepAlive?: boolean

Значение свойства

boolean

method

Метод HTTP для использования.

method: HttpMethods

Значение свойства

HttpMethods

onDownloadProgress

Обратный вызов, который запускается при выполнении скачивания.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Значение свойства

(progress: TransferProgressEvent) => void

onUploadProgress

Обратный вызов, который запускается при выполнении отправки.

onUploadProgress?: (progress: TransferProgressEvent) => void

Значение свойства

(progress: TransferProgressEvent) => void

operationResponseGetter

Функция, возвращающая правильное сочетание OperationResponse для заданной комбинации OperationSpec и HttpOperationResponse. Если это не определено, будет использоваться простой поиск кода состояния.

operationResponseGetter?: (operationSpec: OperationSpec, response: HttpOperationResponse) => undefined | OperationResponse

Значение свойства

(operationSpec: OperationSpec, response: HttpOperationResponse) => undefined | OperationResponse

operationSpec

Спецификация HTTP-запроса.

operationSpec?: OperationSpec

Значение свойства

OperationSpec

proxySettings

Какой прокси-сервер следует использовать при необходимости.

proxySettings?: ProxySettings

Значение свойства

ProxySettings

query

Запрос, добавленный в URL-адрес.

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

Значение свойства

{[key: string]: any}

requestId

Уникальный идентификатор исходящего запроса.

requestId: string

Значение свойства

string

shouldDeserialize

Следует ли десериализировать httpOperationResponse. Если это не определено, необходимо десериализировать httpOperationResponse.

shouldDeserialize?: boolean | (response: HttpOperationResponse) => boolean

Значение свойства

boolean | (response: HttpOperationResponse) => boolean

spanOptions

Трассировка: параметры, используемые для создания диапазона при включении трассировки.

spanOptions?: SpanOptions

Значение свойства

@azure/core-tracing.SpanOptions

streamResponseBody

Предупреждение

Теперь этот API является нерекомендуемым.

Use streamResponseStatusCodes property instead.

Следует ли рассматривать текст httpOperationResponse как поток.

streamResponseBody?: boolean

Значение свойства

boolean

streamResponseStatusCodes

Список кодов состояния, соответствующий текст HttpOperationResponse, должен рассматриваться как поток.

streamResponseStatusCodes?: Set<number>

Значение свойства

Set<number>

timeout

Как долго ждать в миллисекундах перед прерыванием запроса.

timeout: number

Значение свойства

number

tracingContext

Трассировка: контекст, используемый при создании диапазонов.

tracingContext?: Context

Значение свойства

@azure/core-tracing.Context

url

URL-адрес исходящего запроса.

url: string

Значение свойства

string

withCredentials

Следует ли отправлять учетные данные (с помощью файлов cookie, заголовков авторизации или сертификатов клиента TLS) при выполнении запроса в браузере в место назначения между сайтами.

withCredentials: boolean

Значение свойства

boolean

Сведения о методе

clone()

Клонируйте этот объект HTTP-запроса WebResource.

function clone(): WebResource

Возвращаемое значение

WebResource

Клон этого объекта HTTP-запроса WebResource.

prepare(RequestPrepareOptions)

Подготавливает запрос.

function prepare(options: RequestPrepareOptions): WebResource

Параметры

options

RequestPrepareOptions

Параметры для подготовки запроса.

Возвращаемое значение

WebResource

Возвращает подготовленный объект WebResource (HTTP-запрос), который должен быть передан конвейеру запроса.

validateRequestProperties()

Проверяет, определены ли обязательные свойства, такие как метод, URL-адрес, заголовки["Content-Type"], заголовки["accept-language"]. Это приведет к ошибке, если одно из указанных выше свойств не определено.

function validateRequestProperties()