> ## Documentation Index
> Fetch the complete documentation index at: https://acme-c84a37e5.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Introduction
> Type-safe error handling for TypeScript with retry logic and concurrency control
## Welcome to Tryo
A modern, type-safe error handling library that makes async operations predictable and resilient.
Get up and running in less than 5 minutes
Explore the complete API documentation
Real-world examples and patterns
View source code and contribute
## Features
No more `try-catch` blocks. Get discriminated unions with full TypeScript support.
```typescript theme={null}
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.
```typescript theme={null}
await runner.run(() => unstableApi(), {
retry: {
maxRetries: 3,
strategy: RetryStrategies.exponential(1000),
}
});
```
Run multiple operations with controlled parallelism.
```typescript theme={null}
await runner.all(tasks, {
concurrency: 5
});
```
First-class support for `AbortController` and graceful cancellation.
```typescript theme={null}
await runner.run(() => fetch('/api', { signal }), {
ignoreAbort: true
});
```
## Installation
```bash npm theme={null}
npm install tryo
```
```bash pnpm theme={null}
pnpm add tryo
```
```bash yarn theme={null}
yarn add tryo
```
## Quick Example
```typescript theme={null}
import tryo from "tryo";
const runner = tryo();
const result = await runner.run(() => fetch("https://api.example.com/users"), {
retry: {
maxRetries: 3,
strategy: RetryStrategies.fixed(1000),
},
hooks: {
onError: (error) => console.error(error),
}
});
if (result.ok) {
const users = await result.data.json();
console.log(users);
}
```
**Pro tip:** Use `tryo()` once and reuse it across your app for consistent
error handling.
## Next Steps
Learn about Result types and error normalization
See how to use it with React hooks