Introducción

Manejo de errores tipado para TypeScript con lógica de reintentos y control de concurrencia

​

Bienvenido a Trybox

Una librería moderna y tipada para el manejo de errores que hace que las operaciones asíncronas sean predecibles y resilientes.

Inicio Rápido

Empieza en menos de 5 minutos

Referencia de API

Explora la documentación completa de la API

Ejemplos

Ejemplos y patrones del mundo real

GitHub

Ver código fuente y contribuir

​

Características

Manejo de Errores Tipado

No más bloques try-catch. Obtén uniones discriminadas con soporte completo de TypeScript.

const result = await runner.run(() => apiCall());
if (result.ok) {
  // TypeScript sabe que data está disponible
  console.log(result.data);
}

Lógica de Reintentos Inteligente

Backoff exponencial integrado con jitter para prevenir el problema de thundering herd.

await runner.run(() => unstableApi(), {
  retries: 3,
  retryDelay: (attempt) => Math.pow(2, attempt) * 1000,
  jitter: true
});

Control de Concurrencia

Ejecuta múltiples operaciones con paralelismo controlado.

await runner.all(tasks, { 
  concurrency: 5,
  mode: 'fail-fast' 
});

Manejo de Abort

Soporte de primera clase para AbortController y cancelación elegante.

await runner.run(() => fetch('/api', { signal }), {
  ignoreAbort: true
});

​

Instalación

npm

npm install trybox

​

Ejemplo Rápido

import trybox from "trybox";

const runner = trybox();

const result = await runner.run(() => fetch("https://api.example.com/users"), {
  retries: 3,
  retryDelay: 1000,
  onError: (error) => console.error(error),
});

if (result.ok) {
  const users = await result.data.json();
  console.log(users);
}

Consejo Pro: Usa trybox() una vez y reutilízalo en tu aplicación para un manejo de errores consistente.

​

Siguientes Pasos

Conceptos Principales

Aprende sobre tipos Result y normalización de errores

Integración con React

Mira cómo usarlo con hooks de React