Cliente HTTP para TypeScript: mejores bibliotecas para aplicaciones web modernas

Cliente HTTP para TypeScript: mejores bibliotecas para aplicaciones web modernas

TypeScript se ha consolidado como el lenguaje principal para el desarrollo de frontend y aplicaciones de servidor en Node.js. Una de las tareas clave que enfrenta todo desarrollador es el envío de solicitudes HTTP a APIs. La elección del cliente HTTP adecuado afecta el rendimiento, la legibilidad del código y la facilidad de depuración. En este artículo, analizaremos las mejores bibliotecas para trabajar con HTTP en TypeScript, sus características, fortalezas y proporcionaremos ejemplos prácticos de código.

1. Axios — el estándar universal

Axios sigue siendo el cliente HTTP más popular tanto para el navegador como para Node.js. Su principal ventaja es la rica funcionalidad "lista para usar": soporte para interceptores, conversión automática de JSON, cancelación de solicitudes y protección contra XSRF.

En TypeScript, Axios se integra casi perfectamente. Puedes tipificar las respuestas usando genéricos, lo que hace que el código sea seguro y predecible.

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>(`/api/users/${id}`);  return response.data;}

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

Ventajas: gran comunidad, numerosos ejemplos, soporte para progreso de carga, manejo integrado de errores.

Desventajas: el tamaño del bundle (~14 KB comprimido con gzip) puede ser excesivo para proyectos simples.

2. Fetch API — la opción nativa

La Fetch API integrada en los navegadores se ha convertido en los últimos años en un reemplazo completo de XMLHttpRequest. Para los desarrolladores de TypeScript, esto significa la ausencia de dependencias adicionales. Sin embargo, Fetch nativo requiere más trabajo manual: no hay lanzamiento automático de errores en códigos de estado 4xx/5xx, y para Node.js se necesita un polyfill.

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

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

getPosts().then(posts => console.log(posts[0].title));

Ventajas: tamaño de bundle cero, soporte completo para Streams API, arquitectura basada en Promesas.

Desventajas: necesidad de verificar manualmente los estados de respuesta, ausencia de tiempos de espera por defecto, dificultades para cancelar solicitudes (AbortController).

3. Got — una herramienta potente para Node.js

La biblioteca Got está creada específicamente para el entorno de servidor Node.js. Ofrece capacidades avanzadas: soporte para HTTP/2, mecanismos de reintento, almacenamiento en caché, manejo de cookies y proxies. Para TypeScript, Got proporciona una excelente tipificación.

import got from 'got';

interface ApiResponse {  status: string;  data: {    id: number;    value: string;  };}

async function fetchData(): Promise<ApiResponse> {  const response = await got.get('https://api.example.com/data', {    responseType: 'json',    retry: { limit: 3 },    timeout: { request: 5000 }  }).json<ApiResponse>();  return response;}

fetchData().then(result => console.log(result.data.value));

Ventajas: API rico para escenarios complejos, manejo integrado de errores, soporte para streams, excelente documentación.

Desventajas: no funciona en el navegador, tamaño relativamente grande (~10 KB comprimido con gzip), es excesivo para solicitudes GET simples.

4. Ky — ligero y moderno

Ky es un cliente HTTP minimalista construido sobre Fetch API. Resuelve los principales problemas de Fetch nativo: añade ta