Vue Academy · 강의

onErrorCaptured 생명주기 훅

자식 컴포넌트의 오류를 포착하고, 전파를 중단하도록 false를 반환하며, 오류 객체를 다룹니다.

onErrorCaptured 생명주기 훅은(는) CoddyKit의 무료 Vue Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Vue Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

컴포넌트에서 오류 포착하기

Vue는 onErrorCaptured 생명주기 훅을 제공하여 하위 컴포넌트에서 발생한 오류를 포착할 수 있게 합니다. 부모 컴포넌트가 하위 트리에서 발생한 실패를 가로챌 수 있습니다.

훅의 인수 구성

onErrorCaptured는 세 가지 인수를 받습니다. 오류, 오류를 발생시킨 컴포넌트 인스턴스, 그리고 오류가 발생한 위치를 설명하는 info 문자열입니다.

import { onErrorCaptured } from "vue";
onErrorCaptured((err, instance, info) => {
  // handle it
});

err 인수

첫 번째 인수는 발생한 오류 객체입니다. 일반적으로 메시지와 스택을 가진 Error 인스턴스이며, 이를 로그로 기록하거나 화면에 표시할 수 있습니다.

onErrorCaptured((err) => {
  console.error("Captured:", err.message);
});

instance 인수

두 번째 인수는 오류를 발생시킨 컴포넌트 인스턴스입니다. 디버깅하거나 오류 보고서에 맥락을 추가할 때 유용합니다.

onErrorCaptured((err, instance) => {
  console.log("From component:", instance);
});

info 인수

세 번째 인수는 어떤 생명주기나 작업이 오류를 발생시켰는지 알려 주는 문자열입니다. 예를 들어 「렌더링 함수」, 「setup 함수」 또는 특정 훅이 될 수 있습니다.

onErrorCaptured((err, instance, info) => {
  console.log("Vue context:", info);
});

하위 컴포넌트의 오류만 포착하기

중요한 점은 onErrorCaptured가 하위 컴포넌트에서 발생한 오류를 포착하지만, 해당 컴포넌트 자체의 setup이나 렌더링에서 발생한 오류는 포착하지 않는다는 것입니다. 보호하려는 코드의 상위 컴포넌트에 훅을 배치하십시오.

전파 중지하기

기본적으로 포착된 오류는 상위 컴포넌트의 처리기와 전역 처리기로 계속 전파됩니다. 더 이상 전파되지 않도록 하려면 false를 반환하십시오.

onErrorCaptured((err) => {
  reportError(err);
  return false; // do not propagate
});

전파를 중지하는 이유

false를 반환하면 오류가 현재 컴포넌트 안에 머뭅니다. 예를 들어 컴포넌트가 실패를 완전히 처리하여 대체 화면을 표시하고 전역 처리기까지 실행되기를 원하지 않을 때 유용합니다.

오류를 계속 전파하기

상위 수준의 처리기나 전역 처리기도 오류를 확인하게 하려면 false를 반환하지 마십시오. 그러면 훅이 오류를 로컬에 기록하면서 오류가 상위로 계속 전파되도록 합니다.

onErrorCaptured((err) => {
  logLocally(err);
  // no return -> still propagates
});

실용적인 사용 방법

일반적인 사용 방법은 로그 기록과 복구 플래그를 함께 사용하는 것입니다. 반응형 플래그를 설정하여 오류를 보고하는 동안 대체 화면을 렌더링할 수 있습니다.

const failed = ref(false);
onErrorCaptured((err) => {
  failed.value = true;
  report(err);
  return false;
});

비동기 처리 시 주의점

onErrorCaptured는 하위 컴포넌트의 렌더링, 생명주기, 동기 처리기에서 발생한 오류를 포착합니다. 일부 비동기 오류(처리되지 않은 프로미스 거부)는 전역 수준에서 처리하는 편이 좋으며, 이는 뒤에서 다룹니다.

빠른 확인

onErrorCaptured에서 false를 반환하면 어떻게 됩니까?

복습

onErrorCaptured((err, instance, info))가 하위 컴포넌트에서 발생한 오류를 포착한다는 것을 배웠습니다. info 문자열은 생명주기 맥락을 제공하며, false를 반환하면 전파가 중지되어 컴포넌트가 오류를 로컬에서 처리할 수 있습니다.

자주 묻는 질문

“onErrorCaptured 생명주기 훅” 강의는 무료인가요?

네 — “onErrorCaptured 생명주기 훅” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Vue Academy 강의 전체를 잠금 해제할 수 있습니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“onErrorCaptured 생명주기 훅”에서 뭘 배우나요?

자식 컴포넌트의 오류를 포착하고, 전파를 중단하도록 false를 반환하며, 오류 객체를 다룹니다. 브라우저에서 직접 실행하는 실습 코드로 Vue Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Vue Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Vue Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“onErrorCaptured 생명주기 훅” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Vue Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Vue Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Vue Academy(으)로 돌아가기