# GridChunkLoadEventDetail

Fields, allowed values, and APIs that use GridChunkLoadEventDetail.

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

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

## Type definition

A question mark (?) marks an optional field; readonly marks a value you should not change directly. A union (|) accepts one of the listed forms. Functions are callbacks that Grid invokes at the relevant point.

```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>

## APIs using this type

- [chunkLoading](https://grid.syidax.com/docs/events/chunkLoading.md) — Emitted when feature code starts loading. Separate from row data query events.
- [chunkLoaded](https://grid.syidax.com/docs/events/chunkLoaded.md) — Emitted when feature code has loaded.
- [chunkLoadFailed](https://grid.syidax.com/docs/events/chunkLoadFailed.md) — Emitted when feature code loading fails. Use the error and feature name for retry or fallback guidance.

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

## Contracts containing this type

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

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

## Related types

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