supermacro/neverthrow

Health v2 · maintenance only

Adoption not part of the score

7727 stars · 151 forks observed · 2026-09-30

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

neverthrow is a TypeScript library providing a type-safe Result type (Ok/Err) for error handling without exceptions, inspired by Rust. It includes ResultAsync, a thenable wrapper for handling asynchronous errors with the same fluent API.

Use cases

• handle errors without try/catch in typescript
• return errors as values instead of throwing exceptions
• type-safe error handling for async functions
• chain fallible operations with map and andThen
• combine multiple results into one
• wrap promises into result types

When to choose

• you want explicit, compiler-enforced error handling in TypeScript
• you prefer functional programming style over exceptions
• you need ergonomic async error handling with thenable Results

When to avoid

• your codebase relies heavily on exception-based error handling
• you want a zero-dependency minimal Result with no extra API surface
• your team is unfamiliar with functional programming patterns

Facets

library · maturity active

error-handling type-system developer-tools web-development programming-languages browser bun cross-platform result-type functional-programming typescript rust-inspired npm-package nodejs deno

Member repositories

For agents

markdown · JSON · MCP: product_card(name="supermacro/neverthrow")