WebResource class

Vytvoří nový objekt WebResource.

Tato třída poskytuje abstrakci volání REST tím, že je nezávislá na knihovně nebo implementaci a zabalení potřebných vlastností k zahájení požadavku.

Konstruktory

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

Vlastnosti

abortSignal

Signál přerušení kontroleru. Dá se použít k přerušení odesílání síťového požadavku i čekání na odpověď.

body

Text požadavku.

decompressResponse

Zda se má dekomprimovat odpověď podle hlavičky Accept-Encoding (pouze node-fetch)

formData

Data formuláře, která slouží k vytvoření textu požadavku.

headers

Hlavičky HTTP.

keepAlive

Jestli se mají zachovat připojení HTTP v průběhu požadavků.

method

Metoda HTTP, která se má použít.

onDownloadProgress

Zpětné volání, které se aktivuje při průběhu stahování.

onUploadProgress

Zpětné volání, které se aktivuje při průběhu nahrávání.

operationResponseGetter

Funkce, která vrací správnou operationResponse pro danou kombinaci OperationSpec a HttpOperationResponse. Pokud to není definováno, použije se jednoduché vyhledávání stavového kódu.

operationSpec

Specifikace požadavku HTTP.

proxySettings

Jaký proxy server použít, pokud je to potřeba.

query

Dotaz byl přidán k adrese URL.

requestId

Jedinečný identifikátor odchozího požadavku.

shouldDeserialize

Zda httpOperationResponse má být deserializován. Pokud to není definováno, měl by být httpOperationResponse deserializován.

spanOptions

Trasování: Možnosti použité k vytvoření rozsahu při povoleném trasování.

streamResponseBody

Zda se má tělo httpOperationResponse považovat za datový proud.

streamResponseStatusCodes

Seznam stavových kódů, jejichž odpovídající text HttpOperationResponse by měl být považován za datový proud.

timeout

Jak dlouho čekat v milisekundách před přerušením požadavku

tracingContext

Trasování: Kontext použitý při vytváření Spans.

url

Adresa URL odchozího požadavku.

withCredentials

Jestli se mají odesílat přihlašovací údaje (prostřednictvím souborů cookie, autorizačních hlaviček nebo klientských certifikátů TLS) při vytváření požadavku v prohlížeči do cíle mezi weby.

Metody

clone()

Naklonujte tento objekt požadavku HTTP webResource.

prepare(RequestPrepareOptions)

Připraví požadavek.

validateRequestProperties()

Ověří, že jsou definovány požadované vlastnosti, jako jsou method, url, headers["Content-Type"], headers["accept-language"]. Pokud není definována jedna z výše uvedených vlastností, dojde k chybě.

Podrobnosti konstruktoru

WebResource(string, HttpMethods, unknown, {[key: string]: any}, HttpHeadersLike | {[key: string]: any}, 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?: HttpHeadersLike | {[key: string]: any}, 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>)

Parametry

url

string

method
HttpMethods
body

unknown

query

{[key: string]: any}

headers

HttpHeadersLike | {[key: string]: any}

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>

Podrobnosti vlastnosti

abortSignal

Signál přerušení kontroleru. Dá se použít k přerušení odesílání síťového požadavku i čekání na odpověď.

abortSignal?: AbortSignalLike

Hodnota vlastnosti

body

Text požadavku.

body?: any

Hodnota vlastnosti

any

decompressResponse

Zda se má dekomprimovat odpověď podle hlavičky Accept-Encoding (pouze node-fetch)

decompressResponse?: boolean

Hodnota vlastnosti

boolean

formData

Data formuláře, která slouží k vytvoření textu požadavku.

formData?: any

Hodnota vlastnosti

any

headers

Hlavičky HTTP.

headers: HttpHeadersLike

Hodnota vlastnosti

keepAlive

Jestli se mají zachovat připojení HTTP v průběhu požadavků.

keepAlive?: boolean

Hodnota vlastnosti

boolean

method

Metoda HTTP, která se má použít.

method: HttpMethods

Hodnota vlastnosti

onDownloadProgress

Zpětné volání, které se aktivuje při průběhu stahování.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Hodnota vlastnosti

(progress: TransferProgressEvent) => void

onUploadProgress

Zpětné volání, které se aktivuje při průběhu nahrávání.

onUploadProgress?: (progress: TransferProgressEvent) => void

Hodnota vlastnosti

(progress: TransferProgressEvent) => void

operationResponseGetter

Funkce, která vrací správnou operationResponse pro danou kombinaci OperationSpec a HttpOperationResponse. Pokud to není definováno, použije se jednoduché vyhledávání stavového kódu.

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

Hodnota vlastnosti

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

operationSpec

Specifikace požadavku HTTP.

operationSpec?: OperationSpec

Hodnota vlastnosti

proxySettings

Jaký proxy server použít, pokud je to potřeba.

proxySettings?: ProxySettings

Hodnota vlastnosti

query

Dotaz byl přidán k adrese URL.

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

Hodnota vlastnosti

{[key: string]: any}

requestId

Jedinečný identifikátor odchozího požadavku.

requestId: string

Hodnota vlastnosti

string

shouldDeserialize

Zda httpOperationResponse má být deserializován. Pokud to není definováno, měl by být httpOperationResponse deserializován.

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

Hodnota vlastnosti

boolean | (response: HttpOperationResponse) => boolean

spanOptions

Trasování: Možnosti použité k vytvoření rozsahu při povoleném trasování.

spanOptions?: SpanOptions

Hodnota vlastnosti

@azure/core-tracing.SpanOptions

streamResponseBody

Upozornění

Toto rozhraní API je teď zastaralé.

Use streamResponseStatusCodes property instead.

Zda se má tělo httpOperationResponse považovat za datový proud.

streamResponseBody?: boolean

Hodnota vlastnosti

boolean

streamResponseStatusCodes

Seznam stavových kódů, jejichž odpovídající text HttpOperationResponse by měl být považován za datový proud.

streamResponseStatusCodes?: Set<number>

Hodnota vlastnosti

Set<number>

timeout

Jak dlouho čekat v milisekundách před přerušením požadavku

timeout: number

Hodnota vlastnosti

number

tracingContext

Trasování: Kontext použitý při vytváření Spans.

tracingContext?: Context

Hodnota vlastnosti

@azure/core-tracing.Context

url

Adresa URL odchozího požadavku.

url: string

Hodnota vlastnosti

string

withCredentials

Jestli se mají odesílat přihlašovací údaje (prostřednictvím souborů cookie, autorizačních hlaviček nebo klientských certifikátů TLS) při vytváření požadavku v prohlížeči do cíle mezi weby.

withCredentials: boolean

Hodnota vlastnosti

boolean

Podrobnosti metody

clone()

Naklonujte tento objekt požadavku HTTP webResource.

function clone(): WebResource

Návraty

Klon tohoto objektu požadavku HTTP WebResource.

prepare(RequestPrepareOptions)

Připraví požadavek.

function prepare(options: RequestPrepareOptions): WebResource

Parametry

options
RequestPrepareOptions

Možnosti pro přípravu žádosti

Návraty

Vrátí připravený objekt WebResource (požadavek HTTP), který je potřeba dát kanálu požadavku.

validateRequestProperties()

Ověří, že jsou definovány požadované vlastnosti, jako jsou method, url, headers["Content-Type"], headers["accept-language"]. Pokud není definována jedna z výše uvedených vlastností, dojde k chybě.

function validateRequestProperties()