# getColumn

식별자로 현재 열 객체를 찾습니다. 없는 열은 null이며 초기 columnDefs 복사본이 아닌 현재 상태를 조회합니다.

Canonical: https://grid.syidax.com/ko/docs/methods/getColumn/

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

## 무엇을 하는 API인가요

식별자로 현재 열 객체를 찾습니다. 없는 열은 null이며 초기 columnDefs 복사본이 아닌 현재 상태를 조회합니다.

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

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

```typescript
getColumn<TValue = unknown>(columnId: string): Promise<GridColumnRef<GridData, TValue, unknown> | null>
```

| 인수 | 필수 여부 | 타입 |
| --- | --- | --- |
| columnId | 필수 | string |

반환 타입은 `Promise<GridColumnRef<GridData, TValue, unknown> | null>`입니다.

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

## 사용 흐름

등록과 초기화를 마친 Grid 요소에서 grid.getColumn(…)를 호출합니다. 반환값은 await로 읽으세요. boolean이나 보고서를 반환하는 메서드는 결과를 확인한 뒤 다음 작업을 진행합니다.

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

## 관련 타입 읽기

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

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

## 기능별 설명과 예제

- [실시간 열 API](https://grid.syidax.com/ko/docs/features/column-api.md) — 실시간 열 객체는 현재 Grid와 연결된 참조입니다. 저장 가능한 열 상태 배열과 목적이 다릅니다. 특정 열을 조작하는 앱 UI에는 참조가 유용하고 사용자 설정 저장에는 상태 배열이 적합합니다.