Partager via

WebResource class

Paquet:
@azure/core-http

Crée un objet WebResource.

Cette classe fournit une abstraction sur un appel REST en étant indépendant de la bibliothèque/implémentation et en encapsulant les propriétés nécessaires pour lancer une requête.

Constructeurs

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

Propriétés

abortSignal

Signal d’un contrôleur d’abandon. Peut être utilisé pour abandonner à la fois l’envoi d’une demande réseau et l’attente d’une réponse.
body

Corps de la demande.
decompressResponse

Indique s’il faut décompresser ou non la réponse en fonction de l’en-tête Accept-Encoding (node-fetch uniquement)
formData

Données de formulaire, utilisées pour générer le corps de la requête.
headers

En-têtes HTTP.
keepAlive

Indique s’il faut conserver les connexions HTTP actives dans les requêtes.
method

Méthode HTTP à utiliser.
onDownloadProgress

Rappel qui se déclenche lors de la progression du téléchargement.
onUploadProgress

Rappel qui se déclenche lors de la progression du chargement.
operationResponseGetter

Fonction qui retourne la valeur OperationResponse appropriée pour la combinaison OperationSpec et HttpOperationResponse donnée. S’il n’est pas défini, une recherche de code d’état simple sera utilisée.
operationSpec

Spécification de la requête HTTP.
proxySettings

Quel proxy utiliser, si nécessaire.
query

Requête ajoutée à l’URL.
requestId

Identificateur unique de la requête sortante.
shouldDeserialize

Indique si HttpOperationResponse doit être désérialisé ou non. S’il n’est pas défini, httpOperationResponse doit être désérialisé.
spanOptions

Suivi : options utilisées pour créer une étendue lorsque le suivi est activé.
streamResponseBody

Indique si le corps de HttpOperationResponse doit être traité comme un flux.
streamResponseStatusCodes

Liste des codes d’état dont le corps HttpOperationResponse correspondant doit être traité comme un flux.
timeout

Durée d’attente en millisecondes avant d’arrêter la requête.
tracingContext

Suivi : contexte utilisé lors de la création d’étendues.
url

URL de la requête sortante.
withCredentials

Indique s’il faut envoyer des informations d’identification (via des cookies, des en-têtes d’autorisation ou des certificats clients TLS) lors de l’envoi d’une demande dans le navigateur à une destination intersites.

Méthodes

clone()

Clonez cet objet de requête HTTP WebResource.
prepare(RequestPrepareOptions)

Prépare la requête.
validateRequestProperties()

Valide que les propriétés requises, telles que la méthode, l’URL, les en-têtes["Content-Type"], les en-têtes["accept-language"] sont définis. Elle génère une erreur si l’une des propriétés mentionnées ci-dessus n’est pas définie.

Détails du constructeur

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

Paramètres

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>

Détails de la propriété

abortSignal

Signal d’un contrôleur d’abandon. Peut être utilisé pour abandonner à la fois l’envoi d’une demande réseau et l’attente d’une réponse.

abortSignal?: AbortSignalLike

Valeur de propriété

AbortSignalLike

body

Corps de la demande.

body?: any

Valeur de propriété

any

decompressResponse

Indique s’il faut décompresser ou non la réponse en fonction de l’en-tête Accept-Encoding (node-fetch uniquement)

decompressResponse?: boolean

Valeur de propriété

boolean

formData

Données de formulaire, utilisées pour générer le corps de la requête.

formData?: any

Valeur de propriété

any

headers

En-têtes HTTP.

headers: HttpHeadersLike

Valeur de propriété

HttpHeadersLike

keepAlive

Indique s’il faut conserver les connexions HTTP actives dans les requêtes.

keepAlive?: boolean

Valeur de propriété

boolean

method

Méthode HTTP à utiliser.

method: HttpMethods

Valeur de propriété

HttpMethods

onDownloadProgress

Rappel qui se déclenche lors de la progression du téléchargement.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Valeur de propriété

(progress: TransferProgressEvent) => void

onUploadProgress

Rappel qui se déclenche lors de la progression du chargement.

onUploadProgress?: (progress: TransferProgressEvent) => void

Valeur de propriété

(progress: TransferProgressEvent) => void

operationResponseGetter

Fonction qui retourne la valeur OperationResponse appropriée pour la combinaison OperationSpec et HttpOperationResponse donnée. S’il n’est pas défini, une recherche de code d’état simple sera utilisée.

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

Valeur de propriété

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

operationSpec

Spécification de la requête HTTP.

operationSpec?: OperationSpec

Valeur de propriété

OperationSpec

proxySettings

Quel proxy utiliser, si nécessaire.

proxySettings?: ProxySettings

Valeur de propriété

ProxySettings

query

Requête ajoutée à l’URL.

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

Valeur de propriété

{[key: string]: any}

requestId

Identificateur unique de la requête sortante.

requestId: string

Valeur de propriété

string

shouldDeserialize

Indique si HttpOperationResponse doit être désérialisé ou non. S’il n’est pas défini, httpOperationResponse doit être désérialisé.

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

Valeur de propriété

boolean | (response: HttpOperationResponse) => boolean

spanOptions

Suivi : options utilisées pour créer une étendue lorsque le suivi est activé.

spanOptions?: SpanOptions

Valeur de propriété

@azure/core-tracing.SpanOptions

streamResponseBody

Avertissement

Cette API est à présent déconseillée.

Use streamResponseStatusCodes property instead.

Indique si le corps de HttpOperationResponse doit être traité comme un flux.

streamResponseBody?: boolean

Valeur de propriété

boolean

streamResponseStatusCodes

Liste des codes d’état dont le corps HttpOperationResponse correspondant doit être traité comme un flux.

streamResponseStatusCodes?: Set<number>

Valeur de propriété

Set<number>

timeout

Durée d’attente en millisecondes avant d’arrêter la requête.

timeout: number

Valeur de propriété

number

tracingContext

Suivi : contexte utilisé lors de la création d’étendues.

tracingContext?: Context

Valeur de propriété

@azure/core-tracing.Context

url

URL de la requête sortante.

url: string

Valeur de propriété

string

withCredentials

Indique s’il faut envoyer des informations d’identification (via des cookies, des en-têtes d’autorisation ou des certificats clients TLS) lors de l’envoi d’une demande dans le navigateur à une destination intersites.

withCredentials: boolean

Valeur de propriété

boolean

Détails de la méthode

clone()

Clonez cet objet de requête HTTP WebResource.

function clone(): WebResource

Retours

WebResource

Clone de cet objet de requête HTTP WebResource.

prepare(RequestPrepareOptions)

Prépare la requête.

function prepare(options: RequestPrepareOptions): WebResource

Paramètres

options
RequestPrepareOptions

Options permettant de préparer la demande.

Retours

WebResource

Retourne l’objet WebResource (requête HTTP) préparé qui doit être donné au pipeline de requête.

validateRequestProperties()

Valide que les propriétés requises, telles que la méthode, l’URL, les en-têtes["Content-Type"], les en-têtes["accept-language"] sont définis. Elle génère une erreur si l’une des propriétés mentionnées ci-dessus n’est pas définie.

function validateRequestProperties()