# componentError

사용자 컴포넌트 초기화·호출 등에서 오류가 발생했을 때 알립니다. 오류를 무시하지 말고 대상과 단계별로 처리합니다.

Canonical: https://grid.syidax.com/ko/docs/events/componentError/

<a id="meaning"></a>

## 무엇을 하는 API인가요

사용자 컴포넌트 초기화·호출 등에서 오류가 발생했을 때 알립니다. 오류를 무시하지 말고 대상과 단계별로 처리합니다.

<a id="contract"></a>

## 입력과 결과의 정확한 타입

```typescript
componentError: GridComponentErrorDetails
```

<a id="usage"></a>

## 사용 흐름

grid.addEventListener('componentError', handler)로 구독합니다. 실제 결과는 event.detail에 들어 있고 이름의 대소문자를 구분합니다. 화면을 닫을 때 구독을 해제하세요.

```javascript
const controller = new AbortController();
grid.addEventListener('componentError', event => {
  console.log(event.detail);
}, { signal: controller.signal });
// 화면을 해제할 때 controller.abort();
```

<a id="types"></a>

## 관련 타입 읽기

- [GridComponentErrorDetails](https://grid.syidax.com/ko/docs/types/GridComponentErrorDetails.md)

<a id="recipes"></a>

## 기능별 설명과 예제

- [셀 표현 바꾸기](https://grid.syidax.com/ko/docs/features/custom-cells.md) — 셀 렌더러는 데이터의 표시 방법을 바꿉니다. 상태 배지·링크·액션 버튼이 필요한 경우 사용하되 정렬·필터에 사용할 원본 값은 별도로 유지합니다.