Skip to main content
Logo Light

​
Welcome to Trybox

A modern, type-safe error handling library that makes async operations predictable and resilient.

Quick Start

Get up and running in less than 5 minutes

API Reference

Explore the complete API documentation

Examples

Real-world examples and patterns

GitHub

View source code and contribute

​
Features

No more try-catch blocks. Get discriminated unions with full TypeScript support.
const result = await runner.run(() => apiCall());
if (result.ok) {
  // TypeScript knows data is available
  console.log(result.data);
}
Built-in exponential backoff with jitter to prevent thundering herd.
await runner.run(() => unstableApi(), {
  retries: 3,
  retryDelay: (attempt) => Math.pow(2, attempt) * 1000,
  jitter: true
});
Run multiple operations with controlled parallelism.
await runner.all(tasks, { 
  concurrency: 5,
  mode: 'fail-fast' 
});
First-class support for AbortController and graceful cancellation.
await runner.run(() => fetch('/api', { signal }), {
  ignoreAbort: true
});

​
Installation

npm install trybox

​
Quick Example

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);
}
Pro tip: Use trybox() once and reuse it across your app for consistent error handling.

​
Next Steps

Core Concepts

Learn about Result types and error normalization

React Integration

See how to use it with React hooks