Response

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.

The Response interface of the Fetch API represents the response to a request.

You can create a new Response object using the Response.Response() constructor, but you are more likely to encounter a Response object being returned as the result of another API operation, for example a service worker Fetchevent.respondWith, or a simple GlobalFetch.fetch().

Constructor

Response.Response()
Creates a new Response object.

Properties

Response.type Read only
Contains the type of the response (e.g., basic, cors).
Response.url Read only
Contains the URL of the response.
Response.useFinalURL
Contains a boolean stating whether this is the final URL of the response.
Response.status Read only
Contains the status code of the response (e.g., 200 for a success).
Response.ok Read only
Contains a boolean stating whether the response was successful (status in the range 200-299) or not.
Response.statusText Read only
Contains the status message corresponding to the status code (e.g., OK for 200).
Response.headers Read only
Contains the Headers object associated with the response.

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

Body.bodyUsed Read only
Stores a Boolean that declares whether the body has been used in a response yet.

Methods

Response.clone()
Creates a clone of a Response object.
Response.error()
Returns a new Response object associated with a network error.
Response.redirect()
Creates a new response with a different URL.

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

Body.arrayBuffer()
Takes a Response stream and reads it to completion. It returns a promise that resolves with an ArrayBuffer.
Body.blob()
Takes a Response stream and reads it to completion. It returns a promise that resolves with a Blob.
Body.formData()
Takes a Response stream and reads it to completion. It returns a promise that resolves with a FormData object.
Body.json()
Takes a Response stream and reads it to completion. It returns a promise that resolves with a JSON object.
Body.text()
Takes a Response stream and reads it to completion. It returns a promise that resolves with a USVString (text).

Examples

In our basic fetch example (run example live) we use a simple fetch() call to grab an image and display it in an <img> tag. The fetch() call returns a promise, which resolves with the Response object associated with the resource fetch operation. You'll notice that since we are requesting an image, we need to run Body.blob (Response implements body) to give the response its correct MIME type.

var myImage = document.querySelector('.my-image');
fetch('flowers.jpg').then(function(response) {
  return response.blob();
}).then(function(response) {
  var objectURL = URL.createObjectURL(response);
  myImage.src = objectURL;
});

You can also use the Response.Response() constructor to create your own custom Response object:

var myResponse = new Response();

Specifications

Specification Status Comment
Fetch
The definition of 'Response' in that specification.
Living Standard Initial definition

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 42
41[1]
39 (39)
34[1]
No support

29
28[1]

No support
Feature Android Firefox Mobile (Gecko) Firefox OS (Gecko) IE Phone Opera Mobile Safari Mobile Chrome for Android
Basic support No support No support No support No support No support No support No support

[1] This feature is implemented behind a preference.

See also

Document Tags and Contributors

 Contributors to this page: Sheppy, jpmedley, Sebastianz, chrisdavidmills, kscarfone
 Last updated by: Sheppy,