오류 경계 컴포넌트
fallback 슬롯과 오류 표시 기능을 갖춘 ErrorBoundary 래퍼 컴포넌트를 만듭니다.
오류 경계 컴포넌트은(는) CoddyKit의 무료 Vue Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Vue Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
오류 경계란 무엇인가
오류 경계는 UI의 일부를 감싸고 그 내부에서 발생한 오류를 포착하여, 앱 전체가 중단되지 않도록 대체 화면을 보여 주는 재사용 가능한 컴포넌트입니다.
핵심 개념
오류 경계는 hasError 플래그를 유지합니다. 값이 false인 동안에는 자식 콘텐츠를 렌더링하고, 오류가 포착되면 true로 바꾸어 대체 화면을 렌더링합니다.
import { ref } from "vue";
const hasError = ref(false);오류 포착하기
onErrorCaptured를 사용하여 플래그를 설정하고 전파를 중지하면, 오류 경계가 실패를 완전히 관리할 수 있습니다.
import { onErrorCaptured } from "vue";
onErrorCaptured((err) => {
hasError.value = true;
return false;
});오류 세부 정보 저장하기
대체 화면에서 메시지를 표시하거나 다시 시도 기능을 제공할 수 있도록 오류 자체도 저장합니다.
const error = ref(null);
onErrorCaptured((err) => {
hasError.value = true;
error.value = err;
return false;
});템플릿 구조
정상일 때는 기본 슬롯(자식 콘텐츠)을 렌더링하고, 오류가 발생하면 대체 슬롯을 렌더링합니다.
<template>
<slot v-if="!hasError" />
<slot v-else name="fallback" :error="error" />
</template>기본 슬롯에 자식 콘텐츠 표시하기
기본 슬롯에는 보호할 UI가 들어갑니다. 정상적인 상태에서 오류 경계는 보이지 않으며 자식 콘텐츠를 그대로 전달하기만 합니다.
<ErrorBoundary>
<RiskyWidget />
</ErrorBoundary>오류 발생 시 대체 슬롯 표시하기
오류 UI를 위한 이름 있는 fallback 슬롯을 제공합니다. 범위 지정 슬롯 속성을 통해 오류를 전달받을 수 있습니다.
<ErrorBoundary>
<RiskyWidget />
<template #fallback="{ error }">
<p>Something went wrong: {{ error.message }}</p>
</template>
</ErrorBoundary>다시 시도 기능 추가하기
사용자가 복구할 수 있도록 reset을 노출합니다. 메서드가 플래그를 지우고 자식 콘텐츠를 다시 렌더링합니다.
function reset() {
hasError.value = false;
error.value = null;
}대체 화면에서 다시 시도하기
범위 지정 슬롯을 통해 reset을 전달하면 대체 화면에서 「다시 시도」 버튼을 제공할 수 있습니다.
<slot v-else name="fallback" :error="error" :reset="reset" />기본 대체 콘텐츠
사용자 지정 대체 콘텐츠가 제공되지 않아도 경계가 작동하도록 대체 슬롯에 적절한 기본 콘텐츠를 제공하세요.
<slot name="fallback" :error="error">
<p>An error occurred.</p>
</slot>경계가 중요한 이유
경계가 없으면 하나의 오류가 발생한 위젯 때문에 전체 보기가 중단될 수 있습니다. 경계는 오류를 격리하여 나머지 app이 계속 작동하게 하며, 이는 복원력을 높이는 핵심 패턴입니다.
빠른 확인
오류 경계는 무엇을 렌더링할지 어떻게 결정하나요?
복습
오류 경계를 만들었습니다. 여기에는 hasError ref, 값을 설정하고 false를 반환하는 onErrorCaptured, 자식 요소를 위한 기본 슬롯, 그리고 오류가 발생했을 때 표시되는 대체 슬롯(오류와 재설정 기능 포함)이 있습니다. 이 경계는 오류를 나머지 app과 격리합니다.
자주 묻는 질문
“오류 경계 컴포넌트” 강의는 무료인가요?
네 — “오류 경계 컴포넌트” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Vue Academy 강의 전체를 잠금 해제할 수 있습니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“오류 경계 컴포넌트”에서 뭘 배우나요?
fallback 슬롯과 오류 표시 기능을 갖춘 ErrorBoundary 래퍼 컴포넌트를 만듭니다. 브라우저에서 직접 실행하는 실습 코드로 Vue Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Vue Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Vue Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“오류 경계 컴포넌트” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Vue Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Vue Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.