Course contentsShow
← JavaScript
Lesson 2440 of 2,72349. Common Patterns and IdiomsFree lesson

When to Use Result vs Throw

Choosing Result for expected errors in business logic and exceptions for truly exceptional conditions.

When to Use Result vs Throw

You'll learn when to return explicit Result types versus throwing exceptions, so you can design clearer, more predictable error-handling interfaces.

The Core Decision

JavaScript gives you two main error-handling strategies: throwing exceptions and returning Result objects. Choosing between them isn't about one being "better"—it's about matching the right tool to the situation.

Use throw for truly exceptional conditions: situations that indicate a programming error, a violated contract, or something that should never happen in normal operation. Examples include:

  • Invalid function arguments (type errors, null where required)
  • Out-of-bounds array access
  • File system unavailable when it should exist
  • Network stack completely failing

These are exceptional—they're bugs or catastrophic failures, not routine business outcomes.

Use Result for expected failures in business logic: situations where failure is a normal, anticipated outcome that callers should handle explicitly. Examples include:

  • User login with wrong password
  • Validation failures on form input
  • API returning "not found" for a valid query
  • Payment processing declined

These are expected possibilities—not bugs, but legitimate branches in your application's logic.

The Analogy

Think of exceptions like fire alarms: they're loud, disruptive, and force everyone to stop what they're doing. Use them when the building is actually on fire.

Result types are like traffic lights: they're a normal part of navigation, where "red" (error) and "green" (success) are both expected outcomes you calmly respond to.

Practical Guideline

If a caller should reasonably check for the error and handle it as part of normal flow, use Result. If the error means "something is seriously wrong and we can't continue," throw an exception.

Key Takeaway: Use Result for expected business-logic failures that callers should handle explicitly; reserve throw for truly exceptional conditions that indicate bugs or catastrophic problems.