Web/API/Response

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 WindowOrWorkerGlobalScope.fetch().

Constructor

Response(): Creates a new Response object.

Properties

Response.headers Read only: The Headers object associated with the response.
Response.ok Read only: A boolean indicating whether the response was successful (status in the range 200–299) or not.
Response.redirected Read only: Indicates whether or not the response is the result of a redirect (that is, its URL list has more than one entry).
Response.status Read only: The status code of the response. (This will be 200 for a success).
Response.statusText Read only: The status message corresponding to the status code. (e.g., OK for 200).
Response.trailers: A Promise resolving to a Headers object, associated with the response with Response.headers for values of the HTTP Trailer header.
Response.type Read only: The type of the response (e.g., basic, cors).
Response.url Read only: The URL of the response.
Response.useFinalURL: A boolean indicating whether this is the final URL of the response.

Body Interface Properties

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

Body.body Read only: A simple getter exposing a ReadableStream of the body contents.
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.

Body Interface Methods

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 the result of parsing the body text as JSON, which is a JavaScript value of datatype object, string, etc.
Body.text(): Takes a Response stream and reads it to completion. It returns a promise that resolves with a USVString (text).

Examples

Fetching an image

In our basic fetch example ([[../../../../../../mdn.github.io/fetch-examples/basic-fetch/index|run example live]]) we use a simple fetch() call to grab an image and display it in an <img> element. The fetch() call returns a promise, which resolves to 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.

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

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

const response = new Response();

An Ajax Call

Here we call a PHP program file that generates a JSON string, displaying the result as a JSON value, including simple error handling.

// Function to do an Ajax call
const doAjax = async () => {
    const response = await fetch('Ajax.php'); // Generate the Response object
    if (response.ok) {
        const jVal = await response.json(); // Get JSON value from the response body
        return Promise.resolve(jVal);
        }
    else
        return Promise.reject('*** PHP file not found');
    }
}

// Call the function and output value or error message to console
doAjax().then(console.log).catch(console.log);

Specifications

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

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`Response`	Chrome Full support 42 Full support 42 Full support 41 Disabled' Disabled' From version 41: this feature is behind the `Experimental Web Platform Features` preference. To change preferences in Chrome, visit chrome://flags.	Edge Full support 14	Firefox Full support 39 Full support 39 Full support 34 Disabled' Disabled' From version 34: this feature is behind the `dom.fetch.enabled` preference. To change preferences in Firefox, visit about:config.	IE No support No	Opera Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari Full support 10.1	WebView Android Full support 42	Chrome Android Full support 42 Full support 42 Full support 41 Disabled' Disabled' From version 41: this feature is behind the `Experimental Web Platform Features` preference. To change preferences in Chrome, visit chrome://flags.	Firefox Android Full support 39 Full support 39 Full support 34 Disabled' Disabled' From version 34: this feature is behind the `dom.fetch.enabled` preference. To change preferences in Firefox, visit about:config.	Opera Android Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari iOS Full support 10.3	Samsung Internet Android Full support 4.0
`Response()` constructor Experimental'	Chrome Full support 42 Full support 42 Full support 41 Disabled' Disabled' From version 41: this feature is behind the `Experimental Web Platform Features` preference. To change preferences in Chrome, visit chrome://flags.	Edge Full support 14	Firefox Full support 39 Full support 39 Full support 34 Disabled' Disabled' From version 34: this feature is behind the `dom.fetch.enabled` preference. To change preferences in Firefox, visit about:config.	IE No support No	Opera Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari Full support 10.1	WebView Android Full support 42	Chrome Android Full support 42 Full support 42 Full support 41 Disabled' Disabled' From version 41: this feature is behind the `Experimental Web Platform Features` preference. To change preferences in Chrome, visit chrome://flags.	Firefox Android Full support Yes	Opera Android Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari iOS Full support 10.3	Samsung Internet Android Full support 4.0
`clone` Experimental'	Chrome Full support 42 Full support 42 Full support 41 Disabled' Disabled' From version 41: this feature is behind the `Experimental Web Platform Features` preference. To change preferences in Chrome, visit chrome://flags.	Edge Full support 14	Firefox Full support 39 Full support 39 Full support 34 Disabled' Disabled' From version 34: this feature is behind the `dom.fetch.enabled` preference. To change preferences in Firefox, visit about:config.	IE No support No	Opera Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari Full support 10.1	WebView Android No support No	Chrome Android No support No	Firefox Android No support No	Opera Android Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari iOS Full support 10.3	Samsung Internet Android No support No
`error` Experimental'	Chrome Full support Yes	Edge Full support 16	Firefox Full support Yes	IE No support No	Opera Full support Yes	Safari Full support Yes	WebView Android No support No	Chrome Android No support No	Firefox Android No support No	Opera Android No support No	Safari iOS No support No	Samsung Internet Android No support No
`headers` Experimental'	Chrome Full support 42 Full support 42 Full support 41 Disabled' Disabled' From version 41: this feature is behind the `Experimental Web Platform Features` preference. To change preferences in Chrome, visit chrome://flags.	Edge Full support 14	Firefox Full support 39 Full support 39 Full support 34 Disabled' Disabled' From version 34: this feature is behind the `dom.fetch.enabled` preference. To change preferences in Firefox, visit about:config.	IE No support No	Opera Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari No support No	WebView Android No support No	Chrome Android Full support 42	Firefox Android No support No	Opera Android Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari iOS No support No	Samsung Internet Android Full support 4.0
`ok` Experimental'	Chrome Full support 42 Full support 42 Full support 41 Disabled' Disabled' From version 41: this feature is behind the `Experimental Web Platform Features` preference. To change preferences in Chrome, visit chrome://flags.	Edge Full support 14	Firefox Full support 39 Full support 39 Full support 34 Disabled' Disabled' From version 34: this feature is behind the `dom.fetch.enabled` preference. To change preferences in Firefox, visit about:config.	IE No support No	Opera Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari Full support 10.1	WebView Android No support No	Chrome Android No support No	Firefox Android No support No	Opera Android Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari iOS Full support 10.3	Samsung Internet Android No support No
`redirect` Experimental'	Chrome Full support Yes	Edge Full support 16	Firefox Full support Yes	IE No support No	Opera Full support Yes	Safari Full support Yes	WebView Android No support No	Chrome Android No support No	Firefox Android No support No	Opera Android No support No	Safari iOS No support No	Samsung Internet Android No support No
`redirected` Experimental'	Chrome Full support 60	Edge Full support 16	Firefox Full support 49	IE No support No	Opera Full support 47	Safari No support No	WebView Android Full support 60	Chrome Android Full support 60	Firefox Android Full support 49	Opera Android Full support 44	Safari iOS No support No	Samsung Internet Android Full support 8.0
`status` Experimental'	Chrome Full support 42 Full support 42 Full support 41 Disabled' Disabled' From version 41: this feature is behind the `Experimental Web Platform Features` preference. To change preferences in Chrome, visit chrome://flags.	Edge Full support 14	Firefox Full support 39 Full support 39 Full support 34 Disabled' Disabled' From version 34: this feature is behind the `dom.fetch.enabled` preference. To change preferences in Firefox, visit about:config.	IE No support No	Opera Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari Full support 10.1	WebView Android No support No	Chrome Android No support No	Firefox Android No support No	Opera Android Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari iOS Full support 10.3	Samsung Internet Android No support No
`statusText` Experimental'	Chrome Full support 42 Full support 42 Full support 41 Disabled' Disabled' From version 41: this feature is behind the `Experimental Web Platform Features` preference. To change preferences in Chrome, visit chrome://flags.	Edge Full support 14	Firefox Full support 39 Full support 39 Full support 34 Disabled' Disabled' From version 34: this feature is behind the `dom.fetch.enabled` preference. To change preferences in Firefox, visit about:config.	IE No support No	Opera Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari No support No	WebView Android No support No	Chrome Android No support No	Firefox Android No support No	Opera Android Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari iOS No support No	Samsung Internet Android No support No
`type` Experimental'	Chrome Full support 42 Full support 42 Full support 41 Disabled' Disabled' From version 41: this feature is behind the `Experimental Web Platform Features` preference. To change preferences in Chrome, visit chrome://flags.	Edge Full support 14	Firefox Full support 39 Full support 39 Full support 34 Disabled' Disabled' From version 34: this feature is behind the `dom.fetch.enabled` preference. To change preferences in Firefox, visit about:config.	IE No support No	Opera Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari No support No	WebView Android No support No	Chrome Android No support No	Firefox Android No support No	Opera Android Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari iOS No support No	Samsung Internet Android No support No
`url` Experimental'	Chrome Full support 42 Full support 42 Full support 41 Disabled' Disabled' From version 41: this feature is behind the `Experimental Web Platform Features` preference. To change preferences in Chrome, visit chrome://flags.	Edge Full support 14	Firefox Full support 39 Full support 39 Full support 34 Disabled' Disabled' From version 34: this feature is behind the `dom.fetch.enabled` preference. To change preferences in Firefox, visit about:config.	IE No support No	Opera Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari No support No	WebView Android No support No	Chrome Android No support No	Firefox Android No support No	Opera Android Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari iOS No support No	Samsung Internet Android No support No
`useFinalURL` Experimental'Deprecated'	Chrome Full support 42 Full support 42 Full support 41 Disabled' Disabled' From version 41: this feature is behind the `Experimental Web Platform Features` preference. To change preferences in Chrome, visit chrome://flags.	Edge Full support ≤18	Firefox Full support 39 Full support 39 Full support 34 Disabled' Disabled' From version 34: this feature is behind the `dom.fetch.enabled` preference. To change preferences in Firefox, visit about:config.	IE No support No	Opera Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari No support No	WebView Android No support No	Chrome Android No support No	Firefox Android Full support 39 Full support 39 Full support 34 Disabled' Disabled' From version 34: this feature is behind the `dom.fetch.enabled` preference. To change preferences in Firefox, visit about:config.	Opera Android Full support 29 Full support 29 Full support 28 Disabled' Disabled' From version 28: this feature is behind the `Experimental Web Platform Features` preference.	Safari iOS No support No	Samsung Internet Android No support No

Legend

Full support: Full support
No support: No support
Experimental. Expect behavior to change in the future.': Experimental. Expect behavior to change in the future.
Deprecated. Not for use in new websites.': Deprecated. Not for use in new websites.
User must explicitly enable this feature.': User must explicitly enable this feature.