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
for200
). Response.trailers
- A
Promise
resolving to aHeaders
object, associated with the response withResponse.headers
for values of the HTTPTrailer
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 anArrayBuffer
. Body.blob()
- Takes a
Response
stream and reads it to completion. It returns a promise that resolves with aBlob
. Body.formData()
- Takes a
Response
stream and reads it to completion. It returns a promise that resolves with aFormData
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 asJSON
. Body.text()
- Takes a
Response
stream and reads it to completion. It returns a promise that resolves with aUSVString
(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>
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();
Specifications
Specification | Status | Comment |
---|---|---|
Fetch The definition of 'Response' in that specification. |
Living Standard | Initial definition |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Response | Chrome
Full support
42
| Edge Full support ≤18 | Firefox
Full support
39
| IE No support No | Opera
Full support
29
| Safari Full support 10.1 | WebView Android Full support 42 | Chrome Android
Full support
42
| Firefox Android
Full support
39
| Opera Android
Full support
29
| Safari iOS Full support 10.3 | Samsung Internet Android Full support 4.0 |
Response() constructor | Chrome
Full support
42
| Edge Full support 15 | Firefox
Full support
39
| IE No support No | Opera
Full support
29
| Safari Full support 10.1 | WebView Android Full support 42 | Chrome Android
Full support
42
| Firefox Android Full support Yes | Opera Android
Full support
29
| Safari iOS Full support 10.3 | Samsung Internet Android Full support 4.0 |
clone | Chrome
Full support
42
| Edge Full support 14 | Firefox
Full support
39
| IE No support No | Opera
Full support
29
| Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android
Full support
29
| Safari iOS No support No | Samsung Internet Android No support No |
error | 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 | Chrome
Full support
42
| Edge Full support 14 | Firefox
Full support
39
| IE No support No | Opera
Full support
29
| Safari No support No | WebView Android No support No | Chrome Android Full support 42 | Firefox Android No support No | Opera Android
Full support
29
| Safari iOS No support No | Samsung Internet Android No support No |
ok | Chrome
Full support
42
| Edge Full support 14 | Firefox
Full support
39
| IE No support No | Opera
Full support
29
| 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
| Safari iOS Full support 10.3 | Samsung Internet Android No support No |
redirect | 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 | 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 | Chrome
Full support
42
| Edge Full support 14 | Firefox
Full support
39
| IE No support No | Opera
Full support
29
| 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
| Safari iOS Full support 10.3 | Samsung Internet Android No support No |
statusText | Chrome
Full support
42
| Edge Full support 14 | Firefox
Full support
39
| IE No support No | Opera
Full support
29
| Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android
Full support
29
| Safari iOS No support No | Samsung Internet Android No support No |
trailer | Chrome No support No | Edge No support No | Firefox ? | IE No support No | Opera ? | Safari ? | WebView Android No support No | Chrome Android No support No | Firefox Android ? | Opera Android ? | Safari iOS ? | Samsung Internet Android No support No |
type | Chrome
Full support
42
| Edge Full support 14 | Firefox
Full support
39
| IE No support No | Opera
Full support
29
| Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android
Full support
29
| Safari iOS No support No | Samsung Internet Android No support No |
url | Chrome
Full support
42
| Edge Full support 14 | Firefox
Full support
39
| IE No support No | Opera
Full support
29
| Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android
Full support
29
| Safari iOS No support No | Samsung Internet Android No support No |
useFinalURL | Chrome
Full support
42
| Edge Full support ≤18 | Firefox
Full support
39
| IE No support No | Opera
Full support
29
| Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android
Full support
39
| Opera Android
Full support
29
| Safari iOS No support No | Samsung Internet Android No support No |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- 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.