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.

JavaScript
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

URLResultado
/postsLista de 100 posts
/posts/5Post com ID 5
/posts/200Erro 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.

JavaScript
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.

JavaScript
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.

Ícone JavaScriptJavaScript Impressionador

Como usar JavaScript em qualquer empresa e qualquer área, com exemplos totalmente aplicados à realidade do Mercado de Trabalho, seja para se tornar um Desenvolvedor Front End, Backend, Full Stack ou Mobile.

Black Friday · Lote Especial · Lote 1 · Último Lote

De R$ 1.497 56% OFF54% OFF53% OFF

por 12x R$ 6467,5069

Preço do Lote Especial por tempo limitadoPreço do Lote Especial só até amanhã, 13/11, às 23h59Preço do Lote Especial até 13/11, às 23h59Último dia do Lote Especial: o preço vale até hoje, às 23h59Preço do Lote 1 por tempo limitadoPreço do Lote 1 só até amanhã, 20/11, às 23h59Preço do Lote 1 até 20/11, às 23h59Último dia do Lote 1: o preço vale até hoje, às 23h59Preço do Último Lote por tempo limitadoPreço do Último Lote só até amanhã, 27/11, às 23h59Preço do Último Lote até 27/11, às 23h59Último dia do Último Lote: o preço vale até hoje, às 23h59

Começar agoraQuero a oferta de Black FridaySeta para a direita
Fundo JavaScriptTelas JavaScript

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() por await dentro de uma função async e trate os erros com try/catch, como no exemplo abaixo, que também define um tempo limite para a resposta.
JavaScript
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 nome TimeoutError. Para cancelar por uma ação do usuário, como um botão, use um AbortController e passe o signal dele ao fetch.

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!

Caso prefira esse conteúdo no formato de vídeo-aula, assista ao vídeo abaixo ou acesse o nosso canal do YouTube!

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 fetch na forma mais básica, só com a URL de uma API pública
  • 2:42 - Ver no console o que o fetch devolve: uma promessa
  • 3:17 - .then para 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 .catch com essa resposta de erro
  • 7:33 - Testar a propriedade ok da resposta com if
  • 9:06 - A requisição GET, que o fetch faz por padrão, e a opção method
  • 10:21 - Converter o objeto JavaScript com JSON.stringify para enviá-lo
  • 10:49 - Informar o tipo do conteúdo no header, com Content-Type

Trechos do vídeo:

  • O fetch devolve 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 fetch segue pelo caminho de sucesso: o .catch só entra quando há erro de conexão, sem chegar ao endereço. Para tratar o erro, a aula testa a propriedade ok da 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 fetch faz quando não recebe opções.
  • O tipo do conteúdo enviado vai no header: application/json quando é 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!


Quer aprender mais sobre JavaScript com um minicurso básico gratuito?

Posts mais recentes de JavaScript

Posts mais recentes da Hashtag Treinamentos