PipelineRequestOptions interface

Settings to initialize a request. Almost equivalent to Partial, but url is mandatory.

Properties

abortSignal

Used to abort the request later.

allowInsecureConnection

Set to true if the request is sent over HTTP instead of HTTPS

body

The HTTP body content (if any)

disableKeepAlive

If the connection should not be reused.

enableBrowserStreams

BROWSER ONLY

A browser only option to enable use of the Streams API. If this option is set and streaming is used (see streamResponseStatusCodes), the response will have a property browserStream instead of blobBody which will be undefined.

Default value is false

formData

To simulate a browser form post

headers

The HTTP headers to use when making the request.

method

The HTTP method to use when making the request.

multipartBody

Body for a multipart request.

onDownloadProgress

Callback which fires upon download progress.

onUploadProgress

Callback which fires upon upload progress.

proxySettings

Proxy configuration.

requestId

A unique identifier for the request. Used for logging and tracing.

streamResponseStatusCodes

A list of response status codes whose corresponding PipelineResponse body should be treated as a stream.

timeout

The number of milliseconds a request can take before automatically being terminated. If the request is terminated, an AbortError is thrown. Defaults to 0, which disables the timeout.

tracingOptions

Options used to create a span when tracing is enabled.

url

The URL to make the request to.

withCredentials

If credentials (cookies) should be sent along during an XHR. Defaults to false.

Property Details

abortSignal

Used to abort the request later.

abortSignal?: AbortSignalLike

Property Value

allowInsecureConnection

Set to true if the request is sent over HTTP instead of HTTPS

allowInsecureConnection?: boolean

Property Value

boolean

body

The HTTP body content (if any)

body?: RequestBodyType

Property Value

disableKeepAlive

If the connection should not be reused.

disableKeepAlive?: boolean

Property Value

boolean

enableBrowserStreams

BROWSER ONLY

A browser only option to enable use of the Streams API. If this option is set and streaming is used (see streamResponseStatusCodes), the response will have a property browserStream instead of blobBody which will be undefined.

Default value is false

enableBrowserStreams?: boolean

Property Value

boolean

formData

To simulate a browser form post

formData?: FormDataMap

Property Value

headers

The HTTP headers to use when making the request.

headers?: HttpHeaders

Property Value

method

The HTTP method to use when making the request.

method?: HttpMethods

Property Value

multipartBody

Body for a multipart request.

multipartBody?: MultipartRequestBody

Property Value

onDownloadProgress

Callback which fires upon download progress.

onDownloadProgress?: (progress: TransferProgressEvent) => void

Property Value

(progress: TransferProgressEvent) => void

onUploadProgress

Callback which fires upon upload progress.

onUploadProgress?: (progress: TransferProgressEvent) => void

Property Value

(progress: TransferProgressEvent) => void

proxySettings

Proxy configuration.

proxySettings?: ProxySettings

Property Value

requestId

A unique identifier for the request. Used for logging and tracing.

requestId?: string

Property Value

string

streamResponseStatusCodes

A list of response status codes whose corresponding PipelineResponse body should be treated as a stream.

streamResponseStatusCodes?: Set<number>

Property Value

Set<number>

timeout

The number of milliseconds a request can take before automatically being terminated. If the request is terminated, an AbortError is thrown. Defaults to 0, which disables the timeout.

timeout?: number

Property Value

number

tracingOptions

Options used to create a span when tracing is enabled.

tracingOptions?: OperationTracingOptions

Property Value

url

The URL to make the request to.

url: string

Property Value

string

withCredentials

If credentials (cookies) should be sent along during an XHR. Defaults to false.

withCredentials?: boolean

Property Value

boolean