Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Response — uma resposta da Fetch API

Response representa uma resposta da Fetch API: o respetivo estado, cabeçalhos e corpo. O corpo é lido de forma assíncrona.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

new Response()
new Response(body)
new Response(body, init)
response.status
response.ok
response.headers
await response.json()
response.clone()

Response é uma Web API definida pelo Fetch Standard, não faz parte de ECMAScript. fetch() devolve uma promessa (Promise) que, quando é resolvida com sucesso, fornece um objeto Response. Também podes criar um objeto deste tipo com new Response(body, init).

status contém o código da resposta, ok indica um estado entre 200 e 299 e headers disponibiliza os cabeçalhos. response.json() lê o corpo de forma assíncrona e analisa o JSON; não cria uma resposta, ao contrário do método estático Response.json().

Em geral, um corpo diferente de null só pode ser utilizado uma vez. bodyUsed tem o valor true quando o fluxo do corpo está no estado «disturbed». Cancelar o fluxo sem o ler também faz com que bodyUsed passe a true, pelo que esta propriedade não permite saber se a leitura começou. Se a resposta tiver um fluxo para o corpo, chama clone() apenas se o fluxo não estiver no estado «disturbed» nem estiver bloqueado. Verifica a disponibilidade da Web API no navegador de destino; a versão de Node do repositório não a confirma.

Exemplos

async function main() {
  const response = new Response('{"name":"Ada"}', {
    status: 201,
    headers: { "Content-Type": "application/json" }
  });

  console.log(response.status, response.ok, response.bodyUsed);
  const data = await response.json();
  console.log(data.name, response.bodyUsed);
}

main().catch(console.error);

Resultado

201 true false
Ada true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes