CatchBoundary for expected errors in Remix

Introduction

CatchBoundary helps you show friendly messages when you expect certain errors in your app. It stops the app from crashing and keeps users informed.

When a user tries to access a page that needs login but they are not logged in.

When a requested resource is not found and you want to show a custom 'Not Found' message.

When a form submission fails validation and you want to display error details.

When an API call returns a known error and you want to handle it gracefully.

Syntax

Remix

export function CatchBoundary() {
  const caught = useCatch();
  return (
    <div>
      <h1>{caught.status} {caught.statusText}</h1>
      <p>{caught.data?.message || 'Something went wrong.'}</p>
    </div>
  );
}

CatchBoundary is a special export in Remix components.

useCatch() hook gives you the error info you can show.

Examples

Simple message showing error status and text.

Remix

export function CatchBoundary() {
  const caught = useCatch();
  return <p>Error {caught.status}: {caught.statusText}</p>;
}

Shows a custom message from the error data.

Remix

export function CatchBoundary() {
  const caught = useCatch();
  return (
    <div>
      <h2>Oops! {caught.status}</h2>
      <p>{caught.data?.message}</p>
    </div>
  );
}

Sample Program

This component catches expected errors like 404 and shows a friendly message instead of a blank page or crash.

Remix

import { useCatch } from '@remix-run/react';

export function CatchBoundary() {
  const caught = useCatch();
  return (
    <main style={{ padding: '1rem' }}>
      <h1>Error {caught.status}</h1>
      <p>{caught.statusText}</p>
      <p>{caught.data?.message || 'Please try again later.'}</p>
    </main>
  );
}

// Example loader that throws a 404 error
export async function loader() {
  throw new Response('Not Found', {
    status: 404,
    statusText: 'Page Not Found'
  });
}

Important Notes

CatchBoundary only catches errors thrown with throw new Response() in Remix loaders or actions.

It does not catch unexpected errors; those go to ErrorBoundary.

Always provide useful messages in data when throwing responses to show in CatchBoundary.

Summary

CatchBoundary shows user-friendly messages for expected errors.

Use useCatch() to get error details inside CatchBoundary.

It improves user experience by handling errors gracefully without crashing.

Practice

1. What is the main purpose of a CatchBoundary in Remix Framework?

easy

A. To display user-friendly messages for expected errors without crashing the app

B. To catch all unexpected errors and log them to the server

C. To replace the default error page with a blank screen

D. To automatically retry failed network requests

Solution

1. Step 1: Understand the role of CatchBoundary

   CatchBoundary is designed to handle expected errors gracefully by showing friendly messages to users.

2. Step 2: Differentiate from other error handling

   Unlike unexpected errors that crash the app, CatchBoundary prevents crashes by catching known error responses.

3. Final Answer:

   To display user-friendly messages for expected errors without crashing the app -> Option A

4. Quick Check:

   CatchBoundary = user-friendly error display [OK]

Hint: CatchBoundary shows expected errors nicely, not crashes [OK]

Common Mistakes:

• Confusing CatchBoundary with global error logging
• Thinking it handles unexpected crashes
• Assuming it retries failed requests

2. Which of the following is the correct way to access error details inside a CatchBoundary component?

easy

A. const caught = useCatch();

B. const error = useError();

C. const error = useBoundary();

D. const caught = useErrorBoundary();

Solution

1. Step 1: Recall the hook for CatchBoundary

   Remix provides useCatch() to get error details inside CatchBoundary.

2. Step 2: Verify other options

   Hooks like useError(), useBoundary(), or useErrorBoundary() do not exist in Remix for this purpose.

3. Final Answer:

   const caught = useCatch(); -> Option A

4. Quick Check:

   useCatch() = error details in CatchBoundary [OK]

Hint: Remember: useCatch() gets error info in CatchBoundary [OK]

Common Mistakes:

• Using non-existent hooks like useError()
• Confusing useCatch() with useErrorBoundary()
• Trying to access error from props instead of hook

3. Given this CatchBoundary code snippet, what will be rendered if the caught status is 404?

export function CatchBoundary() {
  const caught = useCatch();
  return (
    <div>
      <h1>Error {caught.status}</h1>
      <p>{caught.statusText}</p>
    </div>
  );
}

medium

A. Error 404Page Missing

B. Error 500Internal Server Error

C. Error 404Not Found

D. ErrorUnknown Error

Solution

1. Step 1: Identify caught status and statusText

   The caught object has status 404 and statusText 'Not Found' by default for 404 errors.

2. Step 2: Match rendered output

   The component renders <h1>Error 404</h1> and <p>Not Found</p> exactly as in

   Error 404

   Not Found

   .

3. Final Answer:

   <h1>Error 404</h1><p>Not Found</p> -> Option C

4. Quick Check:

   caught.status = 404, caught.statusText = Not Found [OK]

Hint: Caught status and statusText show error info [OK]

Common Mistakes:

• Assuming statusText is 'Page Missing' instead of 'Not Found'
• Mixing up 404 with 500 error messages
• Ignoring caught.status and using static text

4. What is wrong with this CatchBoundary component code?

export function CatchBoundary() {
  const caught = useCatch;
  return (
    <div>Error: {caught.status}</div>
  );
}

medium

A. useCatch should be imported from react, not remix

B. Caught object does not have a status property

C. CatchBoundary must return a fragment, not a div

D. useCatch is not called as a function

Solution

1. Step 1: Check how useCatch is used

   The code assigns const caught = useCatch; without parentheses, so useCatch is not called.

2. Step 2: Understand consequences

   Without calling useCatch(), caught is a function reference, not the error object, causing runtime errors when accessing caught.status.

3. Final Answer:

   useCatch is not called as a function -> Option D

4. Quick Check:

   useCatch() must be called to get error info [OK]

Hint: Always call useCatch() with parentheses [OK]

Common Mistakes:

• Forgetting parentheses on useCatch()
• Assuming caught is error object without calling hook
• Incorrect import source for useCatch

5. You want to show a custom message for 401 Unauthorized errors inside a CatchBoundary. Which code snippet correctly implements this behavior? A)

export function CatchBoundary() {
  const caught = useCatch();
  if (caught.status === 401) {
    return <div>Please log in to access this page.</div>;
  }
  return <div>Error {caught.status}</div>;
}

B)

export function CatchBoundary() {
  const caught = useCatch();
  if (caught.status === 403) {
    return <div>Please log in to access this page.</div>;
  }
  return <div>Error {caught.status}</div>;
}

C)

export function CatchBoundary() {
  const caught = useCatch();
  if (caught.status === 401) {
    return <div>Access denied.</div>;
  }
  return <div>Error {caught.status}</div>;
}

D)

export function CatchBoundary() {
  const caught = useCatch();
  if (caught.status === 401) {
    return <div>Error 401 occurred.</div>;
  }
  return <div>Please log in to access this page.</div>;
}

hard

A. Shows 'Please log in to access this page.' only for 403 errors, else generic error

B. Shows 'Please log in to access this page.' only for 401 errors, else generic error

C. Shows 'Access denied.' for 401 errors, else generic error

D. Shows 'Error 401 occurred.' for 401 errors, else 'Please log in to access this page.'

Solution

1. Step 1: Identify the correct status code and message

   401 means Unauthorized, so the message should prompt login only for status 401.

2. Step 2: Check the conditional logic and fallback

   Shows 'Please log in to access this page.' only for 401 errors, else generic error correctly checks for 401 and shows the login message only then, otherwise shows a generic error with status.

3. Final Answer:

   Shows 'Please log in to access this page.' only for 401 errors, else generic error -> Option B

4. Quick Check:

   401 status triggers login prompt in CatchBoundary [OK]

Hint: Match status code 401 exactly for login message [OK]

Common Mistakes:

• Using wrong status code like 403
• Showing login message for all errors
• Mixing messages between conditions