Response

La interfaz Response de la Fetch API representa la respuesta a una petición.

Tú puedes crear un nuevo objeto Response usando el  constructorResponse.Response() ,pero es más probable encontrar un objeto Response siendo devuelto como resultado de la operación de otra API, por ejemplo un service worker Fetchevent.respondWith, o un simple GlobalFetch.fetch().

Constructor

Response()

Crea un nuevo objeto Response.

Propiedades

Response.headers Read only

Contiene el objeto Headers asociado con la respuesta.

Response.ok Read only

Contiene un estado indicando si la respuesta fue exitosa (estado en el rango  200-299) o no.

Response.redirected Read only

Indica si la respuesta es o no el resultado de una redirección; eso es, su lista de URL tiene más de una entrada.

Response.status Read only

Contiene el código de estado de la respuesta (e.g., 200 si fue exisitosa).

Response.statusText Read only

Contains the status message corresponding to the status code (e.g., OK for 200).

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 implements Body, so it also has the following properties available to it:

Body.body Read only

A simple getter used to expose 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.

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.

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(blob) {
  var objectURL = URL.createObjectURL(blob);
  myImage.src = objectURL;
});

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

var myResponse = new Response();

Specifications

Browser compatibility

See also

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