Cliente HTTP para TypeScript: as melhores bibliotecas |…

Cliente HTTP para TypeScript: visão completa das melhores bibliotecas

No desenvolvimento web moderno com TypeScript, a interação com APIs remotas é uma tarefa básica. A escolha do cliente HTTP correto impacta diretamente o desempenho, a legibilidade do código e a facilidade de depuração. Neste artigo, vamos analisar as cinco melhores bibliotecas para realizar requisições HTTP em TypeScript, suas características, exemplos de uso e recomendações de escolha.

1. Axios — o padrão universal

Axios continua sendo o cliente HTTP mais popular no ecossistema TypeScript. Ele oferece uma API conveniente baseada em promessas, transformação automática de JSON e suporte nativo a interceptadores (interceptors).

Principais características:

Suporte a navegadores e Node.js (nativo)
Análise automática de respostas JSON
Cancelamento de requisições via CancelToken ou AbortController
Proteção contra XSRF
Tipagem completa para TypeScript

Exemplo de uso com TypeScript:

import axios, { AxiosResponse } from 'axios';

interface User {  id: number;  name: string;  email: string;}

async function fetchUser(id: number): Promise<User> {  const response: AxiosResponse<User> = await axios.get<User>(    `https://jsonplaceholder.typicode.com/users/${id}`  );  return response.data;}

// UsofetchUser(1).then(user => console.log(user.name));

Axios é ideal para projetos grandes, onde é necessário um ajuste fino das requisições e tratamento de erros.

2. Fetch API — abordagem nativa

A moderna Fetch API está integrada em todos os navegadores e Node.js (a partir da versão 18). Ela é leve, não requer instalação de pacotes adicionais, mas exige tratamento manual de erros e análise.

Vantagens:

Sem dependências
Suporte a streams e Service Workers
Integração nativa com TypeScript via generics

Exemplo com TypeScript:

interface Post {  userId: number;  id: number;  title: string;  body: string;}

async function getPost(id: number): Promise<Post> {  const response = await fetch(    `https://jsonplaceholder.typicode.com/posts/${id}`  );  if (!response.ok) {    throw new Error(`HTTP error! status: ${response.status}`);  }  return response.json() as Promise<Post>;}

getPost(1).then(post => console.log(post.title));

Recomendada para projetos pequenos ou quando é necessário minimizar o tamanho do bundle.

3. Ky — minimalismo e praticidade

Ky é um wrapper leve sobre a Fetch API, criado pela equipe Sindre Sorhus. Ele adiciona funcionalidades úteis: novas tentativas, timeouts, análise automática de JSON e gerenciamento conveniente de erros.

Características:

Tamanho de apenas ~2 KB (gzip)
Novas tentativas automáticas em erros de rede
Suporte a AbortController
Suporte completo a TypeScript

Exemplo de código:

import ky from 'ky';

interface Product {  id: number;  title: string;  price: number;}

async function getProduct(id: number): Promise<Product> {  const product = await ky    .get(`https://fakestoreapi.com/products/${id}`)    .json<Product>();  return product;}

getProduct(1).then(product => console.log(product.title));

Ky é excelente para aplicações web modernas, onde desempenho e simplicidade são importantes.

4. Got — cliente poderoso para Node.js

Got é um dos clientes HTTP mais funcionais para Node.js. Ele suporta cache, streams, proxies, novas tentativas e tratamento avançado de erros. Comple