WebResource class

Pakket:

@azure/core-http

Hiermee maakt u een nieuw WebResource-object.

Deze klasse biedt een abstractie van een REST-aanroep door bibliotheek-/implementatieneutraal te zijn en de benodigde eigenschappen te verpakken om een aanvraag te starten.

Constructors

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

Eigenschappen

abortSignal	Signaal van een afgebroken controller. Kan worden gebruikt om zowel het verzenden van een netwerkaanvraag als het wachten op een antwoord af te breken.
body	Aanvraagbody.
decompressResponse	Of antwoord al dan niet moet worden gedecomprimerd op basis van Accept-Encoding header (alleen knooppunt ophalen)
formData	Formuliergegevens, die worden gebruikt om de aanvraagbody te bouwen.
headers	HTTP-headers.
keepAlive	Of de HTTP-verbindingen actief moeten blijven tijdens aanvragen.
method	Te gebruiken HTTP-methode.
onDownloadProgress	Callback die wordt geactiveerd bij de voortgang van het downloaden.
onUploadProgress	Callback die wordt geactiveerd bij de voortgang van het uploaden.
operationResponseGetter	Een functie die de juiste OperationResponse retourneert voor de opgegeven combinatie OperationSpec en HttpOperationResponse. Als dit niet is gedefinieerd, wordt een eenvoudige statuscodezoekactie gebruikt.
operationSpec	Specificatie van de HTTP-aanvraag.
proxySettings	Welke proxy moet worden gebruikt, indien nodig.
query	Query toegevoegd aan de URL.
requestId	Unieke id van de uitgaande aanvraag.
shouldDeserialize	Of het HttpOperationResponse moet worden gedeserialiseerd. Als dit niet is gedefinieerd, moet de HttpOperationResponse worden gedeserialiseerd.
spanOptions	Tracering: opties die worden gebruikt om een bereik te maken wanneer tracering is ingeschakeld.
streamResponseBody	Of de hoofdtekst van het HttpOperationResponse moet worden behandeld als een stroom.
streamResponseStatusCodes	Een lijst met statuscodes waarvan de bijbehorende HttpOperationResponse-hoofdtekst moet worden behandeld als een stroom.
timeout	Hoe lang moet worden gewacht in milliseconden voordat de aanvraag wordt afgebroken.
tracingContext	Tracering: context die wordt gebruikt bij het maken van spans.
url	URL van de uitgaande aanvraag.
withCredentials	Of referenties moeten worden verzonden (via cookies, autorisatieheaders of TLS-clientcertificaten) bij het indienen van een aanvraag in de browser naar een siteoverschrijdende bestemming.

Methoden

clone()	Kloon dit WebResource HTTP-aanvraagobject.
prepare(RequestPrepareOptions)	Bereidt de aanvraag voor.
validateRequestProperties()	Valideert of de vereiste eigenschappen, zoals methode, URL, headers["Content-Type"], headers["accept-language"] zijn gedefinieerd. Er wordt een fout gegenereerd als een van de bovenstaande eigenschappen niet is gedefinieerd.

Constructordetails

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

Parameters

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>

Eigenschapdetails

abortSignal

Signaal van een afgebroken controller. Kan worden gebruikt om zowel het verzenden van een netwerkaanvraag als het wachten op een antwoord af te breken.

abortSignal?: AbortSignalLike

Waarde van eigenschap

AbortSignalLike

body

Aanvraagbody.

body?: any

Waarde van eigenschap

any

decompressResponse

Of antwoord al dan niet moet worden gedecomprimerd op basis van Accept-Encoding header (alleen knooppunt ophalen)

decompressResponse?: boolean

Waarde van eigenschap

boolean

formData

Formuliergegevens, die worden gebruikt om de aanvraagbody te bouwen.

formData?: any

Waarde van eigenschap

any

headers

HTTP-headers.

headers: HttpHeadersLike

Waarde van eigenschap

HttpHeadersLike

keepAlive

Of de HTTP-verbindingen actief moeten blijven tijdens aanvragen.

keepAlive?: boolean

Waarde van eigenschap

boolean

method

Te gebruiken HTTP-methode.

method: HttpMethods

Waarde van eigenschap

HttpMethods

onDownloadProgress

Callback die wordt geactiveerd bij de voortgang van het downloaden.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Waarde van eigenschap

(progress: TransferProgressEvent) => void

onUploadProgress

Callback die wordt geactiveerd bij de voortgang van het uploaden.

onUploadProgress?: (progress: TransferProgressEvent) => void

Waarde van eigenschap

(progress: TransferProgressEvent) => void

operationResponseGetter

Een functie die de juiste OperationResponse retourneert voor de opgegeven combinatie OperationSpec en HttpOperationResponse. Als dit niet is gedefinieerd, wordt een eenvoudige statuscodezoekactie gebruikt.

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

Waarde van eigenschap

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

operationSpec

Specificatie van de HTTP-aanvraag.

operationSpec?: OperationSpec

Waarde van eigenschap

OperationSpec

proxySettings

Welke proxy moet worden gebruikt, indien nodig.

proxySettings?: ProxySettings

Waarde van eigenschap

ProxySettings

query

Query toegevoegd aan de URL.

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

Waarde van eigenschap

{[key: string]: any}

requestId

Unieke id van de uitgaande aanvraag.

requestId: string

Waarde van eigenschap

string

shouldDeserialize

Of het HttpOperationResponse moet worden gedeserialiseerd. Als dit niet is gedefinieerd, moet de HttpOperationResponse worden gedeserialiseerd.

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

Waarde van eigenschap

boolean | (response: HttpOperationResponse) => boolean

spanOptions

Tracering: opties die worden gebruikt om een bereik te maken wanneer tracering is ingeschakeld.

spanOptions?: SpanOptions

Waarde van eigenschap

@azure/core-tracing.SpanOptions

streamResponseBody

Waarschuwing

Deze API is nu afgeschaft.

Use streamResponseStatusCodes property instead.

Of de hoofdtekst van het HttpOperationResponse moet worden behandeld als een stroom.

streamResponseBody?: boolean

Waarde van eigenschap

boolean

streamResponseStatusCodes

Een lijst met statuscodes waarvan de bijbehorende HttpOperationResponse-hoofdtekst moet worden behandeld als een stroom.

streamResponseStatusCodes?: Set<number>

Waarde van eigenschap

Set<number>

timeout

Hoe lang moet worden gewacht in milliseconden voordat de aanvraag wordt afgebroken.

timeout: number

Waarde van eigenschap

number

tracingContext

Tracering: context die wordt gebruikt bij het maken van spans.

tracingContext?: Context

Waarde van eigenschap

@azure/core-tracing.Context

url

URL van de uitgaande aanvraag.

url: string

Waarde van eigenschap

string

withCredentials

Of referenties moeten worden verzonden (via cookies, autorisatieheaders of TLS-clientcertificaten) bij het indienen van een aanvraag in de browser naar een siteoverschrijdende bestemming.

withCredentials: boolean

Waarde van eigenschap

boolean

Methodedetails

clone()

Kloon dit WebResource HTTP-aanvraagobject.

function clone(): WebResource

Retouren

WebResource

De kloon van dit WebResource HTTP-aanvraagobject.

prepare(RequestPrepareOptions)

Bereidt de aanvraag voor.

function prepare(options: RequestPrepareOptions): WebResource

Parameters

options

RequestPrepareOptions

Opties voor het voorbereiden van de aanvraag.

Retouren

WebResource

Retourneert het voorbereide WebResource-object (HTTP Request) dat moet worden gegeven aan de aanvraagpijplijn.

validateRequestProperties()

Valideert of de vereiste eigenschappen, zoals methode, URL, headers["Content-Type"], headers["accept-language"] zijn gedefinieerd. Er wordt een fout gegenereerd als een van de bovenstaande eigenschappen niet is gedefinieerd.

function validateRequestProperties()