https://ko.react.dev/reference/react/Suspense

์ž์‹์ด ๋กœ๋”ฉ์„ ์™„๋ฃŒํ•  ๋•Œ๊นŒ์ง€ fallback์„ ํ‘œ์‹œํ•œ๋‹ค

<Suspense fallback={<Loading/>}>
   <SomeComponent/>
</Suspense>

Props

  • children : ๋ Œ๋”๋งํ•˜๋ ค๋Š” ์‹ค์ œ UI. ๋ Œ๋”๋ง ๋™์•ˆ children์ด ์ผ์‹œ์ค‘๋‹จ๋˜๋ฉด Suspense ๊ฒฝ๊ณ„๊ฐ€ fallback์œผ๋กœ ์ „ํ™˜๋œ๋‹ค.
  • fallback : children์ด ์ผ์‹œ์ค‘๋‹จ๋˜๋Š” ๋™์•ˆ ๋Œ€์ฒดํ•  UI. fallback ๋˜ํ•œ ์ค‘๋‹จ๋˜๋ฉด ๊ฐ€์žฅ ๊ฐ€๊นŒ์šด ์ƒ์œ„ Suspense๊ฐ€ ํ™œ์„ฑํ™”๋œ๋‹ค.

Caveats

  • React๋Š” ์ฒ˜์Œ ๋งˆ์šดํŠธ ํ•˜๊ธฐ ์ „์— ์ผ์‹œ ์ค‘๋‹จ๋œ ๋ Œ๋”๋ง์˜ state๋ฅผ ๋ณด์กดํ•˜์ง€ ์•Š๋Š”๋‹ค. ์ปดํฌ๋„ŒํŠธ ๋กœ๋“œ ํ›„ ์ผ์‹œ ์ค‘๋‹จ๋œ ๋ Œ๋”๋ง์„ ์ฒ˜์Œ๋ถ€ํ„ฐ ๋‹ค์‹œ ์‹œ๋„ํ•˜๋‹ค.
  • Suspense๊ฐ€ ์ฝ˜ํ…์ธ ๋ฅผ ํ‘œ์‹œํ•˜๊ณ  ์žˆ๋‹ค๊ฐ€ ๋‹ค์‹œ ์ผ์‹œ ์ค‘๋‹จ๋˜๋ฉด, ๊ทธ๊ฒƒ์ด startTransition์ด๋‚˜ useDeferredValue๋กœ ์ธํ•œ ๊ฒƒ์ด ์•„๋‹Œ ๊ฒฝ์šฐ fallback์ด ๋‹ค์‹œ ํ‘œ์‹œ๋œ๋‹ค.
  • React๊ฐ€ ๋‹ค์‹œ ์ผ์‹œ ์ค‘๋‹จ๋˜์–ด ์ฝ˜ํ…์ธ ๋ฅผ ์ˆจ๊ฒจ์•ผํ•˜๋Š” ๊ฒฝ์šฐ, ์ฝ˜ํ…์ธ  ํŠธ๋ฆฌ์—์„œ useLayoutEffect๋ฅผ ํด๋ฆฐ์—…ํ•œ๋‹ค. ์ดํ›„ ๋‹ค์‹œ ํ‘œ์‹œํ•  ์ค€๋น„๊ฐ€ ๋˜๋ฉด useLayoutEffect๋ฅผ ๋‹ค์‹œ ์‹คํ–‰ํ•จ์œผ๋กœ์จ ์ฝ˜ํ…์ธ ๊ฐ€ ์ˆจ๊ฒจ์ ธ์žˆ๋Š” ๋™์•ˆ DOM ๋ ˆ์ด์•„์›ƒ์„ ์ธก์ •ํ•˜๋Š” Effect๊ฐ€ ํ•ด๋‹น ์ž‘์—…์„ ์‹œ๋„ํ•˜์ง€ ์•Š๋„๋ก ํ•œ๋‹ค.
  • React์—๋Š” Suspense์™€ ํ†ตํ•ฉ๋œ ์ŠคํŠธ๋ฆฌ๋ฐ ์„œ๋ฒ„ ๋ Œ๋”๋ง ๋ฐ ์„ ํƒ์  Hydration๊ณผ ๊ฐ™์€ ์ตœ์ ํ™”๊ฐ€ ํฌํ•จ๋˜์–ด ์žˆ๋‹ค.

Suspense ๋ฐœ๋™ ์กฐ๊ฑด

์˜ค์ง Suspense๋ฅผ ๋„์ž…ํ•œ ๋ฐ์ดํ„ฐ ์†Œ์Šค์—์„œ๋งŒ Suspense ๋ฅผ ํ™œ์„ฑํ™”ํ•  ์ˆ˜ ์žˆ๋‹ค.

  • Relay ๋ฐ next.js์™€ ๊ฐ™์€ Suspense ๋„์ž… ํ”„๋ ˆ์ž„์›Œํฌ๋ฅผ ์‚ฌ์šฉํ•œ ๋ฐ์ดํ„ฐ ํŒจ์นญ
  • lazy๋ฅผ ์‚ฌ์šฉํ•œ ์ง€์—ฐ ๋กœ๋”ฉ ์ปดํฌ๋„ŒํŠธ ์ฝ”๋“œ
  • use๋ฅผ ์‚ฌ์šฉํ•ด์„œ Promise ๊ฐ’ ์ฝ๊ธฐ

Effect๋‚˜ ์ด๋ฒคํŠธ ํ•ธ๋“ค๋Ÿฌ ๋‚ด๋ถ€์—์„œ ๋ฐ์ดํ„ฐ ํŒจ์นญ์„ ํ•˜๋Š” ๊ฒฝ์šฐ๋Š” ๊ฐ์ง€ํ•˜์ง€ ์•Š๋Š”๋‹ค. ํ”„๋ ˆ์ž„์›Œํฌ๋ฅผ ์ œ์™ธํ•œ Suspense์˜ ์‚ฌ์šฉ์€ ํ˜„์žฌ๋กœ์ฌ ์ง€์›๋˜์ง€ ์•Š๋Š”๋‹ค.

Usage

Revealing content together at once

Suspense ์•„๋ž˜ ์ปดํฌ๋„ŒํŠธ๋Š” ๊ทธ ์ค‘ ํ•˜๋‚˜๋งŒ ์ผ์‹œ ์ค‘๋‹จ๋˜์–ด๋„ ์ „์ฒด๊ฐ€ fallback์œผ๋กœ ๋Œ€์ฒด๋œ๋‹ค.

<Suspense fallback={<Loading />}>
    <Biography artistId={artist.id} />
    <Panel>
	    <Albums artistId={artist.id} />
    </Panel>
</Suspense>

Revealing nested content as it loads

์ปดํฌ๋„ŒํŠธ๊ฐ€ ์ผ์‹œ ์ค‘๋‹จ๋˜๋ฉด ๊ฐ€์žฅ ๊ฐ€๊นŒ์šด Suspense๊ฐ€ fallback์„ ํ‘œ์‹œํ•œ๋‹ค. ์ด๋ฅผ ์ค‘์ฒฉํ•˜์—ฌ ๋กœ๋”ฉ ์‹œํ€€์Šค๋ฅผ ๋งŒ๋“ค ์ˆ˜ ์žˆ๋‹ค.

<Suspense fallback={<BigSpinner />}>  
	<Biography />  
	<Suspense fallback={<AlbumsGlimmer />}>  
		<Panel>  
			<Albums />  
		</Panel>  
	</Suspense>  
</Suspense>
  • Biography๊ฐ€ ์™„๋ฃŒ๋˜๋ฉด ๋จผ์ € ํ‘œ์‹œํ•˜๊ณ , Album์ด ์™„๋ฃŒ๋  ๋•Œ๊นŒ์ง€ ๋‘๋ฒˆ์งธ Suspense๋Š” ์ž์‹ ์˜ fallback์„ ํ‘œ์‹œํ•œ๋‹ค.

Showing stale content while fresh content is loading

useDeferredValue์„ ์‚ฌ์šฉํ•˜์—ฌ ์—…๋ฐ์ดํŠธ๋ฅผ ์—ฐ๊ธฐํ•˜๊ณ  fallback ๋Œ€์‹  ์ด์ „ ๊ฒฐ๊ณผ๋ฅผ ๊ณ„์† ํ‘œ์‹œํ•  ์ˆ˜๋„ ์žˆ๋‹ค.

import { Suspense, useState, useDeferredValue } from 'react';
import SearchResults from './SearchResults.js';
 
export default function App() {
  const [query, setQuery] = useState('');
  const deferredQuery = useDeferredValue(query);
  const isStale = query !== deferredQuery;
  return (
    <>
      <label>
        Search albums:
        <input value={query} onChange={e => setQuery(e.target.value)} />
      </label>
      <Suspense fallback={<h2>Loading...</h2>}>
        <div style={{ opacity: isStale ? 0.5 : 1 }}>
          <SearchResults query={deferredQuery} />
        </div>
      </Suspense>
    </>
  );
}
 
  • startTransition๋„ ๋งˆ์ฐฌ๊ฐ€์ง€๋กœ ํ•  ์ˆ˜ ์žˆ๋‹ค.

Preventing already revealed content from hiding

startTransition์„ ์‚ฌ์šฉํ•˜์—ฌ ์—…๋ฐ์ดํŠธ ๋ฐœ์ƒ ์‹œ ์ด๋ฏธ ํ‘œ์‹œ๋œ ์ฝ˜ํ…์ธ ๋ฅผ fallback ๋Œ€์‹  ๊ณ„์† ํ‘œ์‹œํ•  ์ˆ˜ ์žˆ๋‹ค.

import { Suspense, startTransition, useState } from 'react';
import IndexPage from './IndexPage.js';
import ArtistPage from './ArtistPage.js';
import Layout from './Layout.js';
 
export default function App() {
  return (
    <Suspense fallback={<BigSpinner />}>
      <Router />
    </Suspense>
  );
}
 
function Router() {
  const [page, setPage] = useState('/');
 
  function navigate(url) {
    startTransition(() => {
      setPage(url);
    });
  }
 
  let content;
  if (page === '/') {
    content = (
      <IndexPage navigate={navigate} />
    );
  } else if (page === '/the-beatles') {
    content = (
      <ArtistPage
        artist={{
          id: 'the-beatles',
          name: 'The Beatles',
        }}
      />
    );
  }
  return (
    <Layout>
      {content}
    </Layout>
  );
}
 
function BigSpinner() {
  return <h2>๐ŸŒ€ Loading...</h2>;
}

review