Skip to content

Primeiros Passos com Typed Fetch

Typed Fetch é um cliente HTTP type-safe para TypeScript que nunca lança exceções. Inspirado no padrão de tratamento de erros do Go, é construído sobre a API Fetch nativa.

O Que o Projeto Exporta

  • typedFetch: A função principal para fazer requisições HTTP. Ela tem a mesma assinatura da API fetch nativa (aceitando uma URL e um objeto RequestInit opcional), mas retorna um objeto estruturado com uma resposta ou um erro, nunca lançando exceções.
  • Classes de erro individuais: Classes de erro específicas exportadas individualmente para otimização de tree-shaking, cobrindo diferentes códigos de status HTTP e erros de rede.

Vantagens da Abordagem

  • Nunca Lança Exceções: Erros são retornados como valores, tornando o tratamento explícito e previsível.
  • Type-Safe: Suporte completo ao TypeScript para respostas e erros.
  • Tratamento de Erros Explícito: Segue a filosofia do Go onde erros são valores, não exceções.
  • Construído sobre Fetch Nativo: Sobrecarga mínima com API familiar.
  • Classes de Erro Específicas: Fácil de lidar com diferentes erros HTTP de forma distinta.

Para instalação e uso básico, veja as próximas seções.

Lançado sob a Licença MIT.