# GridChunkLoadEventDetail

GridChunkLoadEventDetail의 필드와 허용 값, 이 타입을 사용하는 API입니다.

Canonical: https://grid.syidax.com/ko/docs/types/GridChunkLoadEventDetail/

<a id="definition"></a>

## 타입 정의

물음표(?)는 선택 항목이고 readonly는 직접 변경하지 않는 값입니다. 유니온(|)은 허용된 형태 중 하나를 뜻합니다. 함수는 해당 시점에 Grid가 호출할 콜백입니다.

```typescript
export interface GridChunkLoadEventDetail {
  readonly chunkId: GridChunkId;
  readonly kind: GridChunkKind;
  readonly tier: GridChunkTier;
  readonly phase: 'loading' | 'loaded' | 'failed';
  readonly attempt: number;
  readonly durationMs?: number;
  readonly reason?: GridChunkFailureReason;
  readonly message?: string;
  readonly httpStatus?: number;
}
```

<a id="used-by"></a>

## 이 타입을 사용하는 API

- [chunkLoading](https://grid.syidax.com/ko/docs/events/chunkLoading.md) — 기능 코드 조각의 로딩이 시작되었을 때 발생합니다. 행 데이터 조회 이벤트와 구분합니다.
- [chunkLoaded](https://grid.syidax.com/ko/docs/events/chunkLoaded.md) — 기능 코드 조각을 불러왔을 때 발생합니다.
- [chunkLoadFailed](https://grid.syidax.com/ko/docs/events/chunkLoadFailed.md) — 기능 코드 로딩이 실패했을 때 발생합니다. 오류와 대상 기능을 확인해 재시도·대체 안내에 연결합니다.

<a id="parents"></a>

## 이 타입을 포함하는 계약

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

<a id="related"></a>

## 연결된 타입

- [GridChunkId](https://grid.syidax.com/ko/docs/types/GridChunkId.md)
- [GridChunkKind](https://grid.syidax.com/ko/docs/types/GridChunkKind.md)
- [GridChunkTier](https://grid.syidax.com/ko/docs/types/GridChunkTier.md)
- [GridChunkFailureReason](https://grid.syidax.com/ko/docs/types/GridChunkFailureReason.md)