# captureSnapshot

현재 원본 데이터의 이름 있는 스냅샷을 만들고 ID를 반환합니다. 화면 열 배치 저장과는 다릅니다.

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

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

## 무엇을 하는 API인가요

현재 원본 데이터의 이름 있는 스냅샷을 만들고 ID를 반환합니다. 화면 열 배치 저장과는 다릅니다.

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

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

```typescript
captureSnapshot(name?: string): Promise<string>
```

| 인수 | 필수 여부 | 타입 |
| --- | --- | --- |
| name | 선택 | string |

반환 타입은 `Promise<string>`입니다.

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

## 사용 흐름

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

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

## 기능별 설명과 예제

- [데이터 스냅샷](https://grid.syidax.com/ko/docs/features/snapshots.md) — 스냅샷은 특정 시점의 rowData를 보관하고 현재 데이터 또는 다른 스냅샷과 비교합니다. 열 너비·필터·포커스를 저장하는 화면 상태 API와는 목적이 다릅니다.