Como Usar Fetch API em JavaScript: Guia Completo para Iniciantes
Neste guia, aprenda como usar Fetch API, uma ferramenta poderosa do JavaScript para requisições HTTP.
Em resumo: para usar a Fetch API, chame fetch(url), que devolve uma promise com a resposta, e leia o corpo com resposta.json(). Para enviar dados, passe um objeto de opções com method, headers e body. O fetch é nativo nos navegadores e no Node.js 18 ou superior, mas não trata 404 ou 500 como erro: confira resposta.ok antes de usar os dados.
Se você está começando no desenvolvimento web e quer entender como consumir APIs de forma simples, este guia é para você! Vamos explorar como o Fetch API funciona, como tratar respostas e erros, e como configurar requisições GET e POST, tudo com exemplos práticos e linguagem acessível.
O que é o Fetch API e por que usá-lo?
O Fetch API é uma interface moderna do JavaScript que permite fazer requisições HTTP (como GET e POST) de forma mais simples e flexível que o antigo XMLHttpRequest. Ele é nativo nos navegadores e, a partir da versão 18, também no Node.js, ou seja, não precisa de bibliotecas externas, e trabalha com promises, facilitando o manejo de operações assíncronas.
- Por que usar?
- Código mais limpo e legível.
- Suporte a promises para lidar com respostas assíncronas.
- Flexibilidade para configurar cabeçalhos, métodos e dados enviados.
Para fazer o download do(s) arquivo(s) utilizados na aula, preencha com o seu e-mail:
Não vamos te encaminhar nenhum tipo de SPAM! A Hashtag Treinamentos é uma empresa preocupada com a proteção de seus dados e realiza o tratamento de acordo com a Lei Geral de Proteção de Dados (Lei n. 13.709/18). Qualquer dúvida, nos contate.
Como fazer uma requisição GET com o Fetch API?
A requisição GET é usada para buscar dados de uma API.
Vamos usar a API pública jsonplaceholder.typicode.com para testar.
fetch('https://jsonplaceholder.typicode.com/posts')
.then(resposta => resposta.json())
.then(json => console.log(json));A requisição acima retorna uma lista de 100 posts com id, title, e outros campos. Para buscar um post específico, adicione o ID na URL, como /posts/5.
Resultados de requisições GET
| URL | Resultado |
|---|---|
| /posts | Lista de 100 posts |
| /posts/5 | Post com ID 5 |
| /posts/200 | Erro 404 (não encontrado) |
Como tratar erros em requisições com o Fetch?
O Fetch não considera respostas como 404 ou 500 como erros. Ele só rejeita a promise quando a requisição não se completa: falha de rede, URL inválida, bloqueio de CORS ou cancelamento. Para tratar erros HTTP, precisamos verificar a propriedade ok da resposta e, quando ela for falsa, lançar um erro com throw, para que ele caia no .catch.
fetch('https://jsonplaceholder.typicode.com/posts/200')
.then(resposta => {
if (!resposta.ok) {
throw new Error(`Erro HTTP ${resposta.status}`);
}
return resposta.json();
})
.then(json => console.log(json))
.catch(erro => console.log('Algo deu errado:', erro.message));Dica: sempre verifique resposta.ok (verdadeiro para os status de 200 a 299) antes de ler o corpo. Sem o throw, o segundo .then rodaria mesmo com o 404 e imprimiria undefined. Para mensagens diferentes por tipo de erro, use resposta.status.
Como fazer uma requisição POST com o Fetch API?
A requisição POST é usada para enviar dados a uma API, como criar um novo recurso. Para isso, configuramos o método, cabeçalhos e corpo da requisição.
fetch('https://jsonplaceholder.typicode.com/posts', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
userId: 1,
title: 'Novo Post',
body: 'Conteúdo do post'
})
})
.then(resposta => {
if (!resposta.ok) {
throw new Error(`Erro HTTP ${resposta.status}`);
}
return resposta.json();
})
.then(json => console.log(json))
.catch(erro => console.log('Algo deu errado:', erro.message));Nota: a jsonplaceholder não grava o post de verdade: ela devolve uma resposta simulada, com status 201 e o objeto enviado acrescido de um id (101) gerado pelo servidor. Por isso o id não vai no corpo da requisição.
Quais são os próximos passos para usar o Fetch API?
Agora que você sabe o básico, aqui estão algumas ideias para avançar:
- Explorar outros métodos HTTP: Teste PUT (atualizar) e DELETE (excluir).
- Usar async/await: troque os
.then()porawaitdentro de uma funçãoasynce trate os erros comtry/catch, como no exemplo abaixo, que também define um tempo limite para a resposta.
async function buscarPost() {
try {
const resposta = await fetch('https://jsonplaceholder.typicode.com/posts/1', {
signal: AbortSignal.timeout(5000)
});
if (!resposta.ok) {
throw new Error(`Erro HTTP ${resposta.status}`);
}
const json = await resposta.json();
console.log(json);
} catch (erro) {
if (erro.name === 'TimeoutError') {
console.log('A API levou mais de 5 segundos para responder');
} else {
console.log('Algo deu errado:', erro.message);
}
}
}
buscarPost();- Integrar com projetos reais: Consuma APIs de terceiros, como a do GitHub ou OpenWeather.
- Tratar erros avançados: Verifique status específicos (ex.: 401, 403) para mensagens personalizadas.
- Definir um tempo limite: o
AbortSignal.timeout(5000)do exemplo acima cancela a requisição depois de 5 segundos com um erro de nomeTimeoutError. Para cancelar por uma ação do usuário, como um botão, use umAbortControllere passe osignaldele aofetch.
Conclusão - Como usar Fetch API em JavaScript
O Fetch API é uma ferramenta essencial para desenvolvedores web que querem interagir com APIs de forma prática e moderna. Com ele, você pode buscar dados (GET), enviar informações (POST) e tratar erros de forma eficiente.
Comece praticando com APIs públicas como a jsonplaceholder e, aos poucos, integre o Fetch em seus projetos. Experimente os exemplos deste post e explore async/await para tornar seu código ainda mais limpo!
O que você aprende neste vídeo
Resposta rápida: Introdução ao Fetch API em JavaScript, praticada no console com uma API pública: uma requisição GET devolve uma promessa, vira JSON com dois .then, e a resposta 404 não cai no .catch. A aula termina enviando dados com method, JSON.stringify e o header Content-Type.
Neste vídeo (13 min):
- 1:49 - O
fetchna forma mais básica, só com a URL de uma API pública - 2:42 - Ver no console o que o
fetchdevolve: uma promessa - 3:17 -
.thenpara agir assim que a promessa for respondida - 4:48 -
resposta.json()para transformar a resposta em JSON, que também é uma promessa - 5:50 - Pedir um post que não existe e receber o 404
- 6:41 - Teste do
.catchcom essa resposta de erro - 7:33 - Testar a propriedade
okda resposta comif - 9:06 - A requisição GET, que o
fetchfaz por padrão, e a opçãomethod - 10:21 - Converter o objeto JavaScript com
JSON.stringifypara enviá-lo - 10:49 - Informar o tipo do conteúdo no header, com
Content-Type
Trechos do vídeo:
- O
fetchdevolve uma promessa de que, no futuro, entregará algo. Por isso o resultado só pode ser lido depois, quando ela for respondida. - Mesmo quando a resposta é um erro como o 404, o
fetchsegue pelo caminho de sucesso: o.catchsó entra quando há erro de conexão, sem chegar ao endereço. Para tratar o erro, a aula testa a propriedadeokda resposta antes de converter para JSON. - Abrir a URL de uma API no navegador já é uma requisição do tipo GET, a mesma que o
fetchfaz quando não recebe opções. - O tipo do conteúdo enviado vai no header:
application/jsonquando é JSON, e também é possível enviar texto ou dados de formulário.
Perguntas frequentes
1. O fetch funciona no Node.js?
Sim. O fetch é global no Node.js desde a versão 18, sem instalar pacote nenhum, e deixou de ser experimental na versão 21. Em versões anteriores, era preciso usar uma biblioteca como o node-fetch.
2. Como tratar um erro 404 ou 500 com o fetch?
O fetch só rejeita a promise em falha de rede, URL inválida ou cancelamento; um 404 ou 500 chega como resposta normal. Confira resposta.ok e lance um erro com throw quando ele for falso, para que o .catch ou o try/catch trate o problema.
3. Como colocar um tempo limite (timeout) no fetch?
Passe signal: AbortSignal.timeout(5000) nas opções do fetch. Depois de 5 segundos sem resposta, a requisição é cancelada com um erro de nome TimeoutError, que você trata no catch.
4. Como enviar JSON numa requisição POST com fetch?
Informe method: 'POST', o header 'Content-Type': 'application/json' e o corpo convertido com JSON.stringify(objeto). Sem o JSON.stringify, o servidor não recebe o objeto no formato JSON.
5. Qual a diferença entre fetch e axios?
O fetch é nativo do navegador e do Node.js, enquanto o axios é uma biblioteca que precisa ser instalada. O axios converte o JSON e trata status de erro sozinho; com o fetch, você chama resposta.json() e confere resposta.ok no seu código.
Hashtag Treinamentos
Para acessar publicações de JavaScript, clique aqui!
Posts mais recentes de JavaScript
- Try Catch no JavaScript: Programação Defensiva na PráticaAprenda a usar try catch no JavaScript e melhore a sua programação defensiva!
- ExpressJS: Crie APIs de forma rápida e prática com JavaScriptO ExpressJS simplifica a criação de APIs com JavaScript e Node.js. Aprenda passo a passo a montar seu backend com rotas, testes e um exemplo prático de controle de estoque.
- Método forEach no JavaScript: automatize tarefas repetitivasAprenda como usar o Método forEach no JavaScript para automatizar tarefas repetitivas e gerar tabelas dinâmicas de forma prática e eficiente.
Posts mais recentes da Hashtag Treinamentos
- ChatGPT para criar fórmulas no Excel: 5 exemplos práticosAprenda a usar o ChatGPT para criar fórmulas no Excel com 5 exemplos práticos de SOMA, SOMASES, SE, PROCV e CONT.SES, e veja como pedir certo e validar.
- Cursor para iniciantes: tutorial completo passo a passoCursor para iniciantes: aprenda a instalar, configurar o modelo, usar os modos Plan e Ask e criar sua primeira automação em Python com IA.
- Claude Artifacts: crie dashboards, slides e sites com IAAprenda a usar o Claude Artifacts para criar dashboards, apresentações e sites com IA a partir de um prompt, com exemplos e prompts prontos para copiar.







