Response

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨março de 2017⁩.

* Some parts of this feature may have varying levels of support.

A interfaceResponse daFetch API representa a resposta para uma requisição.

Você pode criar um novo objetoResponse usando o construtorResponse.Response(), porém é mais provável você encontrar um objeto Response sendo retornado como o resultado de uma outra operação da API, por exemplo um service workerFetchevent.respondWith, ou um simplesGlobalFetch.fetch().

Construtor

Response(): Cria um novo objetoResponse.

Propriedades

Response.headersSomente leitura: Contém o objetoHeaders associado à resposta.
Response.okSomente leitura: Contém um valor booleano indicando se a resposta foi bem sucedida ("status" no intervalo 200-299) ou não.
Response.redirectedSomente leitura: Indica se a resposta é ou não o resultado de um redirecionamento; isto é, sua lista de URL tem mais de uma entrada.
Response.statusSomente leitura: Contém o código de "status" da resposta (ex.,200 para um sucesso).
Response.statusTextSomente leitura: Contém a mensagem de "status" correspondente ao código de "status" (ex.,OK para200).
Response.typeSomente leitura: Contém o tipo da resposta (ex.,basic,cors).
Response.urlSomente leitura: Contém a URL de resposta.
Response.useFinalURL: Contém um valor boleano indicando se essa é a URL final da resposta.

Response implementaBody, por isso também tem as seguintes propriedades disponíveis:

Body.bodySomente leitura: Um simples "getter" para ler do conteúdo do corpo através da interfaceReadableStream.
Body.bodyUsedSomente leitura: Armazena umBoolean que indica se o corpo já foi utilizado em uma resposta.

Métodos

Response.clone(): Cria uma cópia do objetoResponse.
Response.error(): Retorna um novo objetoResponse associado a um erro de rede.
Response.redirect(): Cria uma nova resposta com uma URL diferente.

Response implementaBody, por isso também tem as seguintes propriedades disponíveis:

Body.arrayBuffer(): Recebe um "stream"Response e lê até a conclusão. Retorna uma "promise" que resolve com umArrayBuffer.
Body.blob(): Recebe um "stream"Response e lê até a conclusão. Retorna uma "promise" que resolve com umBlob.
Body.formData(): Recebe um "stream"Response e lê até a conclusão. Retorna uma "promise" que resolve com um objetoFormData.
Body.json(): Recebe um "stream"Response e lê até a conclusão. Retorna uma "promise" que resolve com o resultado do parseamento do texto do corpo comoJSON.
Body.text(): Recebe um "stream"Response e lê até a conclusão. Retorna uma "promise" que resolve com umUSVString (texto).

Exemplos

Em nossoexemplo básico fetch (executar exemplo live) nós usamos uma simples chamadafetch() para pegar uma imagem e exibi-la em uma tag<img>. A chamadafetch() retorna uma "promise", que resolve com o objetoResponse associado com o recurso da operação "fetch". Você irá notar que como estamos solicitando uma imagem, nós precisamos executarBody.blob (Response implementa o "body") para dar à resposta seu tipo MIME correto.

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;  });

Você também pode usar o construtorResponse.Response() para criar seu objetoResponse personalizado: