Why error boundaries matter in NextJS

Introduction

Error boundaries help your app stay working even when some parts have problems. They catch errors in components so the whole app doesn't crash.

When you want to show a friendly message instead of a broken screen if a part of your app fails.

When you want to log errors from components to fix bugs later.

When you want to keep other parts of your app usable even if one part crashes.

When you want to improve user experience by avoiding full app crashes.

When you want to isolate errors to specific parts of your UI.

Syntax

NextJS

import { ErrorBoundary } from 'react-error-boundary';

function ErrorFallback({ error, resetErrorBoundary }) {
  return (
    <div role="alert">
      <p>Something went wrong:</p>
      <pre>{error.message}</pre>
      <button onClick={resetErrorBoundary}>Try again</button>
    </div>
  );
}

function App() {
  return (
    <ErrorBoundary
      FallbackComponent={ErrorFallback}
      onReset={() => {
        // reset the state of your app here
      }}
    >
      <YourComponent />
    </ErrorBoundary>
  );
}

Error boundaries catch errors in their child components during rendering, lifecycle methods, and constructors.

They do not catch errors inside event handlers.

Examples

Basic error boundary wrapping a component with a simple fallback UI.

NextJS

import { ErrorBoundary } from 'react-error-boundary';

function ErrorFallback({ error }) {
  return <div>Error: {error.message}</div>;
}

function App() {
  return (
    <ErrorBoundary FallbackComponent={ErrorFallback}>
      <MyComponent />
    </ErrorBoundary>
  );
}

Error boundary with a reset handler to recover from errors.

NextJS

import { ErrorBoundary } from 'react-error-boundary';

function ErrorFallback({ error, resetErrorBoundary }) {
  return (
    <div role="alert">
      <p>Something went wrong:</p>
      <pre>{error.message}</pre>
      <button onClick={resetErrorBoundary}>Try again</button>
    </div>
  );
}

function App() {
  return (
    <ErrorBoundary
      FallbackComponent={ErrorFallback}
      onReset={() => {
        // reset app state
      }}
    >
      <MyComponent />
    </ErrorBoundary>
  );
}

Sample Program

This example shows a counter button that crashes when it reaches 3. The error boundary catches the crash and shows a friendly message with a retry button.

NextJS

import React, { useState } from 'react';
import { ErrorBoundary } from 'react-error-boundary';

function BuggyCounter() {
  const [count, setCount] = useState(0);
  if (count === 3) {
    throw new Error('I crashed at 3!');
  }
  return <button onClick={() => setCount(count + 1)}>Count: {count}</button>;
}

function ErrorFallback({ error, resetErrorBoundary }) {
  return (
    <div role="alert">
      <p>Oops! Something went wrong:</p>
      <pre>{error.message}</pre>
      <button onClick={resetErrorBoundary}>Try again</button>
    </div>
  );
}

export default function App() {
  return (
    <ErrorBoundary
      FallbackComponent={ErrorFallback}
      onReset={() => {
        // reset logic if needed
      }}
    >
      <BuggyCounter />
    </ErrorBoundary>
  );
}

Important Notes

Use error boundaries to prevent your whole app from crashing due to one component's error.

Always provide a fallback UI so users know something went wrong.

Resetting error boundaries helps users recover without reloading the page.

Summary

Error boundaries catch errors in parts of your app to keep it running.

They improve user experience by showing friendly messages instead of broken screens.

Use them to isolate errors and allow recovery with reset options.

Practice

1. What is the main purpose of error boundaries in a Next.js application?

easy

A. To catch JavaScript errors in components and display a fallback UI

B. To improve SEO by optimizing page metadata

C. To handle server-side rendering errors automatically

D. To manage user authentication and sessions

Solution

1. Step 1: Understand error boundaries role

   Error boundaries catch errors in React components during rendering, lifecycle methods, and constructors.

2. Step 2: Identify their main benefit

   They prevent the whole app from crashing by showing a fallback UI instead of a broken screen.

3. Final Answer:

   To catch JavaScript errors in components and display a fallback UI -> Option A

4. Quick Check:

   Error boundaries catch errors = B [OK]

Hint: Error boundaries catch errors and show fallback UI [OK]

Common Mistakes:

• Confusing error boundaries with authentication
• Thinking error boundaries improve SEO
• Assuming error boundaries handle server errors automatically

2. Which of the following is the correct way to define an error boundary component in Next.js using React functional components?

easy

A. class ErrorBoundary extends React.Component { constructor() { super(); this.state = { hasError: false }; } componentDidCatch() { this.setState({ hasError: true }); } render() { if (this.state.hasError) return Error occurred; return this.props.children; } }

B. function ErrorBoundary({ children }) { const [hasError, setHasError] = React.useState(false); if (hasError) return Error; return children; }

C. function ErrorBoundary({ children }) { try { return children; } catch { return Error; } }

D. class ErrorBoundary extends React.Component { state = { error: null }; render() { if (this.state.error) return Error; return this.props.children; } }

Solution

1. Step 1: Recall error boundary implementation

   Error boundaries must be class components with lifecycle methods like componentDidCatch to catch errors.

2. Step 2: Check options for correct syntax

   class ErrorBoundary extends React.Component { constructor() { super(); this.state = { hasError: false }; } componentDidCatch() { this.setState({ hasError: true }); } render() { if (this.state.hasError) return <div>Error occurred</div>; return this.props.children; } } correctly defines a class component with constructor, state, componentDidCatch, and render method.

3. Final Answer:

   class ErrorBoundary extends React.Component { constructor() { super(); this.state = { hasError: false }; } componentDidCatch() { this.setState({ hasError: true }); } render() { if (this.state.hasError) return <div>Error occurred</div>; return this.props.children; } } -> Option A

4. Quick Check:

   Error boundaries require class + componentDidCatch = C [OK]

Hint: Error boundaries must be class components with componentDidCatch [OK]

Common Mistakes:

• Trying to create error boundaries as functional components
• Missing componentDidCatch lifecycle method
• Not initializing state to track errors

3. Given the following error boundary component and a child component that throws an error, what will be rendered?

class ErrorBoundary extends React.Component {
  constructor(props) {
    super(props);
    this.state = { hasError: false };
  }
  componentDidCatch(error, info) {
    this.setState({ hasError: true });
  }
  render() {
    if (this.state.hasError) {
      return <h1>Something went wrong.</h1>;
    }
    return this.props.children;
  }
}

function BuggyComponent() {
  throw new Error('Bug!');
  return <div>No bugs</div>;
}

// Usage
<ErrorBoundary>
  <BuggyComponent />
</ErrorBoundary>

medium

A. Uncaught Error: Bug!

B. No bugs

C. Something went wrong.

D. Blank screen

Solution

1. Step 1: Understand error throwing in child

   BuggyComponent throws an error immediately when rendered.

2. Step 2: Check error boundary response

   ErrorBoundary catches the error in componentDidCatch and sets hasError to true, rendering fallback UI.

3. Final Answer:

   <h1>Something went wrong.</h1> -> Option C

4. Quick Check:

   Error caught, fallback UI shown = A [OK]

Hint: ErrorBoundary shows fallback UI when child throws error [OK]

Common Mistakes:

• Expecting child component output despite error
• Thinking error is uncaught and crashes app
• Assuming blank screen instead of fallback UI

4. You have this error boundary component but it does not catch errors as expected. What is the likely problem?

function ErrorBoundary({ children }) {
  try {
    return children;
  } catch (error) {
    return <div>Error occurred</div>;
  }
}

medium

A. Try-catch works fine for error boundaries in functional components

B. Error boundaries must be class components with componentDidCatch method

C. You forgot to wrap children in a React.Fragment

D. You need to use useErrorBoundary hook instead

Solution

1. Step 1: Analyze error boundary implementation

   Try-catch inside a functional component does not catch errors during rendering lifecycle in React.

2. Step 2: Recall React error boundary requirements

   Error boundaries must be class components implementing componentDidCatch lifecycle method to catch errors properly.

3. Final Answer:

   Error boundaries must be class components with componentDidCatch method -> Option B

4. Quick Check:

   Functional try-catch won't catch render errors = A [OK]

Hint: Error boundaries require class + componentDidCatch, not try-catch [OK]

Common Mistakes:

• Using try-catch in functional components expecting error boundary behavior
• Assuming React has a useErrorBoundary hook
• Thinking wrapping children in fragments fixes error catching

5. You want to add a reset button in your error boundary to let users try again after an error. Which approach correctly implements this behavior?

hard

A. Use a useEffect hook to reset error state automatically after 5 seconds

B. Reload the entire page using window.location.reload() when the button is clicked

C. Wrap the reset button in a try-catch block to prevent errors

D. Add a button that calls this.setState({ hasError: false }) inside the error boundary's fallback UI

Solution

1. Step 1: Understand reset behavior in error boundaries

   Resetting error state allows the component tree to re-render normally after an error.

2. Step 2: Identify correct reset method

   Calling this.setState({ hasError: false }) inside the error boundary resets the error state and shows children again.

3. Final Answer:

   Add a button that calls this.setState({ hasError: false }) inside the error boundary's fallback UI -> Option D

4. Quick Check:

   Reset error state with setState = D [OK]

Hint: Reset error by setting hasError false in state [OK]

Common Mistakes:

• Reloading page instead of resetting state
• Using try-catch around reset button unnecessarily
• Relying on automatic reset with useEffect without user action