Request

The Request interface of the Fetch API represents a resource request.

You can create a new Request object using the Request.Request() constructor, but you are more likely to encounter a Request object being returned as the result of another API operation, such as a service worker FetchEvent.request.

Constructor

Request.Request()

Creates a new Request object.

Properties

Request.method Lecture seule

Contains the request's method (GET, POST, etc.)

Request.url Lecture seule

Contains the URL of the request.

Request.headers Lecture seule

Contains the associated Headers object of the request.

Request.context Lecture seule  

Contains the context of the request (e.g., audio, image, iframe, etc.)

Request.referrer Lecture seule

Contains the referrer of the request (e.g., client).

Request.referrerPolicy Lecture seule

Contains the referrer policy of the request (e.g., no-referrer).

Request.mode Lecture seule

Contains the mode of the request (e.g., cors, no-cors, same-origin, navigate.)

Request.credentials Lecture seule

Contains the credentials of the request (e.g., omit, same-origin).

Request.redirect Lecture seule

Contains the mode for how redirects are handled. It may be one of follow, error, or manual.

Request.integrity Lecture seule

Contains the subresource integrity value of the request (e.g., sha256-BpfBw7ivV8q2jLiT13fxDYAe2tJllusRSZ273h2nFSE=).

Request.cache Lecture seule

Contains the cache mode of the request (e.g., default, reload, no-cache).

Request implements Body, so it also has the following property available to it:

Body.bodyUsed Lecture seule

Stores a Boolean that declares whether the body has been used in a response yet.

Methods

Request.clone()

Creates a copy of the current Request object.

Request implements Body, so it also has the following methods available to it:

Body.arrayBuffer()

Returns a promise that resolves with an ArrayBuffer representation of the request body.

Body.blob()

Returns a promise that resolves with an Blob representation of the request body.

Body.formData()

Returns a promise that resolves with an FormData representation of the request body.

Body.json()

Returns a promise that resolves with an JSON representation of the request body.

Body.text()

Returns a promise that resolves with an USVString (text) representation of the request body.

Note: The Body functions can be run only once; next calls will resolve with empty strings/ArrayBuffers.

Examples

In the following snippet, we create a new request using the Request() constructor (for an image file in the same directory as the script), then return some property values of the request:

var myRequest = new Request('flowers.jpg');

var myURL = myRequest.url; // http://localhost:8000/flowers.jpg
var myMethod = myRequest.method; // GET
var myCred = myRequest.credentials; // omit

You could then fetch this request by passing the Request object in as a parameter to a GlobalFetch.fetch() call, for example:

fetch(myRequest).then(function(response) {
      return response.blob();
    }).then(function(response) {
      var objectURL = URL.createObjectURL(response);
      myImage.src = objectURL;
    });

Specifications

Browser compatibility

See also

• ServiceWorker API
• HTTP access control (CORS)
• HTTP