본문 바로가기
seungchan.dev
뒤로

React.lazy와 Suspense로 컴포넌트 지연 로딩하기

React.lazy로 동적 import한 컴포넌트를 Suspense로 감싸 로딩 중 fallback을 보여 주는 방법과, lazy에 넘기는 함수가 반환해야 하는 Promise 조건을 정리했습니다.

2분 읽기#React

2023년에 쓴 글이라 지금과 다른 내용이 있을 수 있습니다.

React.lazy 함수를 사용하면 동적 import를 사용해서 컴포넌트를 렌더링할 수 있다.

Before: 일반 import

import OtherComponent from './OtherComponent';

After: React.lazy

const OtherComponent = React.lazy(()=>import('./OtherComponent'));

MyComponent가 처음 렌더링될 때 OtherComponent를 포함한 번들을 자동으로 불러온다. React.lazy는 동적 import()를 호출하는 함수를 인자로 가진다. 이 함수는 React 컴포넌트를 default export로 가진 모듈 객체가 이행되는 Promise를 반환해야 한다.

Suspense로 감싸기

lazy 컴포넌트는 Suspense 컴포넌트 하위에서 렌더링되어야 하며, Suspense는 lazy 컴포넌트가 로드되길 기다리는 동안 로딩 화면과 같은 예비 콘텐츠를 보여 줄 수 있게 해 준다.

javascript
import React, { Suspense } from 'react';
 
const OtherComponent = React.lazy(() => import('./OtherComponent'));
 
function MyComponent() {
  return (
    <div>
      <Suspense fallback={<div>Loading...</div>}>
        <OtherComponent />
      </Suspense>
    </div>
  );
}

fallback prop은 컴포넌트가 로드될 때까지 기다리는 동안 렌더링하려는 React 엘리먼트를 받아들인다. Suspense 컴포넌트는 lazy 컴포넌트를 감싼다.