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.