Requisição, resposta e leitura do corpo
O fetch é uma função que inicia requisições no JavaScript, como uma consulta ao cadastro mantido por um servidor. Ela recebe o endereço do recurso e pode receber opções para definir o método ou enviar um corpo. Seu retorno é uma Promise, um objeto que permite acompanhar a conclusão ou a falha de uma tarefa assíncrona.
Quando a resposta fica disponível, a Promise é resolvida com um objeto Response. Você já pode examinar o status e os cabeçalhos, mas o corpo ainda pode estar chegando. A leitura exige outra etapa: o método json(), por exemplo, aguarda o corpo completo e tenta interpretá-lo como JSON (JavaScript Object Notation), conforme o guia de uso da Fetch API.
Uma consulta que recebe HTTP 404
Uma chamada pode receber o status 404 porque o cadastro consultado não existe. Essa resposta não provoca a rejeição da Promise retornada pelo fetch. O código precisa conferir response.ok, que indica os status de 200 a 299, ou interpretar response.status diretamente. A referência do método distingue esse caso de uma falha de rede.
Neste exemplo didático, a função consulta /api/cadastro na mesma origem da página. A resposta só segue para a leitura como JSON quando o status pertence à faixa de sucesso.
async function consultarCadastro() { const resposta = await fetch('/api/cadastro') if (!resposta.ok) { throw new Error('A consulta retornou HTTP ' + resposta.status) } return resposta.json()}Com status 200 e o corpo {"nome":"Ana"}, a função resolve sua Promise com um objeto cujo campo nome contém “Ana”. Com status 404, ela lança o erro com o número recebido e não tenta ler o corpo. Uma resposta 200 com HTML também faz a função falhar, mas durante a interpretação como JSON. O código que chama consultarCadastro() ainda precisa capturar essas falhas e mostrar uma mensagem adequada na interface.
Leitura de respostas de outra origem
No navegador, o compartilhamento de recursos entre origens, chamado CORS (Cross-Origin Resource Sharing), determina quando o JavaScript pode ler uma resposta de outra origem. A origem combina o esquema do endereço com o host e a porta. Assim, uma página em https://app.example.com e um serviço em https://api.example.com têm origens diferentes.
Definir mode: 'no-cors' não libera a leitura desse serviço. A resposta opaca prevista no padrão Fetch oculta o corpo e os cabeçalhos do código. Para investigar uma chamada, você pode comparar os cabeçalhos recebidos na aba Network com a mensagem do console. A mesma consulta funcionar no terminal não confirma a autorização exigida pelo navegador.
Dúvidas frequentes
Perguntas frequentes sobre fetch
- Uma resposta 404 faz o fetch rejeitar a Promise?
- Uma resposta HTTP 404 pode resolver a Promise normalmente. O fetch rejeita a Promise em falhas como um erro de rede. Para identificar o 404, o código precisa examinar response.status ou verificar response.ok, que só é verdadeiro para os status de 200 a 299.
- O fetch transforma a resposta em JSON automaticamente?
- A chamada fornece um objeto Response. Você usa o método json() para ler o corpo e interpretá-lo como JSON (JavaScript Object Notation). Essa leitura retorna outra Promise e pode falhar mesmo após uma resposta HTTP de sucesso, por exemplo quando o corpo contém HTML.
- O modo no-cors libera a leitura de uma resposta de outra origem?
- Uma requisição a outra origem com no-cors pode produzir uma resposta opaca. O JavaScript recebe o status 0 e não pode ler o corpo nem os cabeçalhos dessa resposta. Para ler a resposta de um serviço de outra origem, a configuração de CORS precisa autorizar o acesso.
Para continuar
Recursos relacionados
Site de referência
Desenvolvimento Colaborativo da Dev Side Studio
Sessão prática com orientação técnica enquanto você examina as requisições da interface e ajusta o código que interpreta as respostas.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O fetch permite conectar a interface aos serviços consultados pela aplicação, com tratamento das respostas e das falhas.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.