Suspense basically suspends the rendering of a component while loading data from a cache. This means that our component will only show up once the whole tree is ready. If the data we’re trying to render is not in the cache, the cache throws a Promise. When the promise resolves, the rendering continues. 
While all of this is happening, Suspense will render a fallback component which could be for example a loading indicator, a message, or anything we usually render in our applications to signal the user that something asynchronous is happening.

A new way to build components

As of today, when we want to render a component that shows some data coming from an asynchronous call in React, we’re stuck with classes. We have to use the component lifecycle methods to ensure the call happens on mount, and use the local state to manage the loading state. We can see below a small example of a pattern that I’m sure pretty much every React developer had to follow:

1
import React, { Component, Fragment } from 'react';
3
class ClassicAsync extends Component {
6
    this.state = { loading: false, title: null };
10
    fetch('https://jsonplaceholder.typicode.com/todos/')
11
      .then((response) => response.json())
12
      .then((json) => this.setState({ loading: false, data: json }));
15
  renderList = (data) => {
19
          <li style={{ listStyle: 'none' }} key={item.id}>
28
    const { loading, data } = this.state;
32
        <h2 style={{ textAlign: 'center' }}>
33
          {`React: ${React.version} Demo`}
35
        {loading ? 'Classic loading placeholder' : this.renderList(data)}
41
export default ClassicAsync;

How Suspense changes that? Well, quite a lot actually if you compare the code above with the following one:

1
import React, { Suspense, Fragment } from 'react';
4
const getDate = () => Fetcher.read();
7
  const data = getData();
11
        <li style={{ listStyle: 'none' }} key={item.id}>
21
    <h2>{`React: ${React.version} Demo`}</h2>
22
    <Suspense fallback={<div>Loading...</div>}>

As we can see with this example: no more class! Suspense is managing for us the loading state through the fallback prop, which is rendered until List is ready to be rendered, that is when the dependent asynchronous call resolves and returns the data. However, this is only a partial example. As stated in the first part, the rendering of List in this example is suspended while loading data from a cache, which is what the Fetcher function is all about.

This is key for getting the example above to work. The caching part is needed for Suspense to read the data from the asynchronous call.
Before diving in the details, let’s look at how the Fetcher function is implemented for our example:

1
import { unstable_createResource } from 'react-cache';
3
const Fetcher = unstable_createResource(() =>
4
  fetcher('https://jsonplaceholder.typicode.com/todos').then((r) => r.json())

For this post I used react-cache. It’s a package made by the React core team that provides a basic cache that is going to store asynchronous data, like the data that we’re getting once our fetch call resolves, and allows us to access that data asynchronously. In the code snippet above we basically use the unstable_createResource function where we pass our asynchronous call, which will initiate a cache and store the resulting data into it. Accessing that data from the cache is done through the read function as we can see in the Code Snippet 2. However, this way of doing caching is currently not meant to be used in production (the React team emphasized this quite a bit in the README of this repository).

Full Example

Here’s the full example for this article:

1
import React, { Suspense, Fragment } from 'react';
2
import { unstable_createResource } from 'react-cache';
4
const Fetcher = unstable_createResource(() =>
5
  fetcher('https://jsonplaceholder.typicode.com/todos').then((r) => r.json())
8
const getDate = () => Fetcher.read();
11
  const data = getData();
15
        <li style={{ listStyle: 'none' }} key={item.id}>
25
    <h2>{`React: ${React.version} Demo`}</h2>
26
    <Suspense fallback={<div>Loading...</div>}>

I made this example available in a Github repository based on create-react-app so you can also give it a try and experiment with Suspense very quickly!

I really can’t wait for this pattern to be ready for production. Combining Suspense and the recently announced React hooks is getting us closer to building React apps fully based on functional components. If you want to learn more about Suspense here’s a really complete summary in a tweet from a member of the React team:

What to read next?
If you want to read more about React or frontend development, you can check the following articles: