Course contentsShow
← React
Lesson 1337 of 2,39634. Suspense FundamentalsFree lesson

What Suspense Is: A Declarative Alternative

Suspense lets you declare 'this subtree might not be ready' and React handles the loading state automatically.

What Suspense Is: A Declarative Alternative

You'll learn: How Suspense shifts loading state management from imperative "if loading, show spinner" code to a declarative "this might not be ready yet" boundary.

The Old Imperative Way

Traditionally, you manage loading states imperatively: check if data is loading, manually render a spinner, handle errors separately, coordinate multiple loading states. You're telling React how to handle each step.

// The imperative approach (what you've been doing)
if (isLoading) return <Spinner />;
if (error) return <Error />;
return <ActualContent data={data} />;

Every component fetching data needs this boilerplate. It's repetitive, error-prone, and hard to coordinate across nested components.

What Suspense Does Differently

Suspense is a declarative boundary around part of your component tree. You're saying: "Hey React, the components inside here might not be ready yet—if they're not, show this fallback while you wait."

<Suspense fallback={<Spinner />}>
  <ComponentThatMightNotBeReady />
</Suspense>

The component inside doesn't need loading state logic. When it's not ready (because it's fetching data, loading code, etc.), React automatically shows the fallback. When it becomes ready, React swaps in the real content.

Think of It Like a Safety Net

Imagine components can "suspend" (pause) when they need something asynchronous. Suspense catches that suspension at the boundary level, just like Error Boundaries catch errors. You define where the loading state appears in your tree, not how each component manages it.

This separates what loads from where the loading UI shows—a more maintainable, composable pattern.

Key Takeaway: Suspense is React's declarative way to say "this subtree might not be ready"—it automatically handles loading states without imperative checking in every component.