Interface Request

This Fetch API interface represents a resource request.

interface Request {
    body: null | ReadableStream<Uint8Array>;
    bodyUsed: boolean;
    cache: RequestCache;
    credentials: RequestCredentials;
    destination: RequestDestination;
    headers: Headers;
    integrity: string;
    keepalive: boolean;
    method: string;
    mode: RequestMode;
    redirect: RequestRedirect;
    referrer: string;
    referrerPolicy: ReferrerPolicy;
    signal: AbortSignal;
    url: string;
    arrayBuffer(): Promise<ArrayBuffer>;
    blob(): Promise<Blob>;
    clone(): Request;
    formData(): Promise<FormData>;
    json(): Promise<any>;
    text(): Promise<string>;
}

Hierarchy (view full)

Properties

body bodyUsed cache credentials destination headers integrity keepalive method mode redirect referrer referrerPolicy signal url

Methods

arrayBuffer blob clone formData json text

Properties

Readonly body

body: null | ReadableStream<Uint8Array>

Readonly bodyUsed

bodyUsed: boolean

Readonly cache

cache: RequestCache

Returns the cache mode associated with request, which is a string indicating how the request will interact with the browser's cache when fetching.

Readonly credentials

credentials: RequestCredentials

Returns the credentials mode associated with request, which is a string indicating whether credentials will be sent with the request always, never, or only when sent to a same-origin URL.

Readonly destination

destination: RequestDestination

Returns the kind of resource requested by request, e.g., "document" or "script".

Readonly headers

headers: Headers

Returns a Headers object consisting of the headers associated with request. Note that headers added in the network layer by the user agent will not be accounted for in this object, e.g., the "Host" header.

Readonly integrity

integrity: string

Returns request's subresource integrity metadata, which is a cryptographic hash of the resource being fetched. Its value consists of multiple hashes separated by whitespace. [SRI]

Readonly keepalive

keepalive: boolean

Returns a boolean indicating whether or not request can outlive the global in which it was created.

Readonly method

method: string

Returns request's HTTP method, which is "GET" by default.

Readonly mode

mode: RequestMode

Returns the mode associated with request, which is a string indicating whether the request will use CORS, or will be restricted to same-origin URLs.

Readonly redirect

redirect: RequestRedirect

Returns the redirect mode associated with request, which is a string indicating how redirects for the request will be handled during fetching. A request will follow redirects by default.

Readonly referrer

referrer: string

Returns the referrer of request. Its value can be a same-origin URL if explicitly set in init, the empty string to indicate no referrer, and "about:client" when defaulting to the global's default. This is used during fetching to determine the value of the Referer header of the request being made.

Readonly referrerPolicy

referrerPolicy: ReferrerPolicy

Returns the referrer policy associated with request. This is used during fetching to compute the value of the request's referrer.

Readonly signal

signal: AbortSignal

Returns the signal associated with request, which is an AbortSignal object indicating whether or not request has been aborted, and its abort event handler.

Readonly url

url: string

Returns the URL of request as a string.

Methods

arrayBuffer

  • arrayBuffer(): Promise<ArrayBuffer>

  • Returns Promise<ArrayBuffer>

blob

  • blob(): Promise<Blob>

  • Returns Promise<Blob>

clone

formData

  • formData(): Promise<FormData>

  • Returns Promise<FormData>

json

  • json(): Promise<any>

  • Returns Promise<any>

text

  • text(): Promise<string>

  • Returns Promise<string>

Settings

Member Visibility

Theme

On This Page