react-error-boundary로 에러 바운더리와 fallback UI 설정하기
에러 바운더리가 잡지 못하는 에러, react-error-boundary의 FallbackComponent 사용법, useErrorHandler로 비동기 에러를 넘기는 법을 정리했습니다.
2023년에 쓴 글이라 지금과 다른 내용이 있을 수 있습니다.
에러 바운더리가 하는 일
에러 바운더리는 하위 컴포넌트 트리의 어디에서든 자바스크립트 에러를 기록하며 깨진 컴포넌트 트리 대신 폴백 UI를 보여 주는 React 컴포넌트로, 에러 경계는 렌더링 도중 생명주기 메서드 및 그 아래에 있는 전체 트리에서 에러를 잡아낸다.
과거에는 컴포넌트 내부의 자바스크립트 에러를 정상적으로 처리할 수 있는 방법이 없었는데, 에러 바운더리를 설정해주면 바운더리 내의 컴포넌트와 그 하위 컴포넌트에서 발생하는 에러를 감지해서 fallback UI를 띄워 줄 수 있다.
에러 바운더리가 포착하지 못하는 것
- 이벤트 핸들러
- 비동기적 코드
- 서버 사이드 렌더링
- 자식에서가 아닌 에러 경계 자체에서 발생하는 에러
$ npm install --save react-error-boundary
function App(){
...
return (
<ErrorBoundary
FallbackComponent={OurFallbackComponent}
>
<ComponentThatMightThrowAnError/>
</ErrorBoundary>
);
}
const OurFallbackComponent = ({ error, resetErrorBoundary }) => {
return (
<div>
<h1>An error occurred: {error.message}</h1>
<button onClick={resetErrorBoundary}>Try again</button>
</div>
);
};
가장 기본적인 사용법은 fallback UI로 사용할 컴포넌트를 생성하고 ErrorBoundary 컴포넌트로 에러 바운더리를 설정한 컴포넌트를 감싸 준 후 FallbackComponent 속성에 생성한 fallback 컴포넌트를 전달하면 된다.
fallback 컴포넌트는 prop으로 error, resetErrorBoundary를 받게 되는데, 에러가 발생했을 때 error에는 에러 정보가 담겨있고 resetErrorBoundary는 실행 시 에러를 초기화한다.
import React, { useState } from "react";
import { useErrorHandler } from "react-error-boundary";
function Greeting() {
const [greeting, setGreeting] = useState(null);
const handleError = useErrorHandler();
async function handleSubmit(event) {
event.preventDefault();
const name = event.target.elements.name.value;
try {
const newGreeting = await fetchGreeting(name);
setGreeting(newGreeting);
} catch (error) {
handleError(error);
}
}
return greeting ? (
<div>{greeting}</div>
) : (
<form onSubmit={handleSubmit}>
<label>Name</label>
<input id="name" />
<button type="submit">get a greeting</button>
</form>
);
}에러 바운더리는 비동기 코드에 대한 에러를 인지하지 못하기 때문에 흔하게 에러가 발생하는 AJAX 요청도 useErrorHandler를 사용하여 처리해 주어야 한다.
같은 주제의 글
스켈레톤 로딩 UI를 어디에, 언제 보여 줄지 정한 기준
스켈레톤 UI를 전체 화면과 일부 영역으로 나눠 적용한 기준, Suspense와 MUI Skeleton으로 만든 부분 로딩, 짧은 로딩에는 스켈레톤을 숨기는 지연 컴포넌트와 이미지용 공통 컴포넌트를 정리했습니다.
Recoil 훅 정리: useRecoilState부터 스냅샷까지
useRecoilState·useRecoilValue·useResetRecoilState와 selector의 set, useRecoilSnapshot·useRecoilTransactionObserver·useRecoilCallback으로 스냅샷을 다루는 법을 정리했습니다.
4분 읽기#ReactSWR suspense 옵션으로 로딩 삼항 연산자 걷어내기
SWRConfig에 suspense: true를 켜고 React Suspense의 fallback으로 로딩 UI를 맡기는 방법을 정리했습니다. React Query도 같은 방식으로 씁니다.