---
url: https://developers.webzenk.kr/sdk/html5/errors.md
---
# 오류 처리 (HTML5)

모든 API는 실패하면 `WKError`를 던집니다.

```js
try {
  await api.storage.set('save', data)
} catch (e) {
  if (e.code === 'VERSION_CONFLICT') { /* 다시 읽어서 합치기 */ }
  else if (e.retryable) { /* 잠시 후 다시 */ }
  else console.error(e.code, e.message, e.traceId)
}
```

| 속성 | 설명 |
|---|---|
| `code` | 서버 오류 코드 또는 SDK 코드 |
| `status` | HTTP 상태 (네트워크 오류는 0) |
| `retryable` | 네트워크·5xx·429 |
| `traceId` | 문의할 때 함께 전달 |
| `details` | 추가 정보 |

## SDK 코드

| code | 뜻 |
|---|---|
| `NETWORK_ERROR` | 오프라인, 타임아웃, CORS 차단(주소가 잘못됨) |
| `NOT_LOGGED_IN` | 로그인 전 호출 |
| `NOT_SUPPORTED` | 현재 플랫폼에 없는 기능 |
| `PLATFORM_ERROR` | 플랫폼 SDK 오류 (`details.platformError`에 원문) |
| `CANCELED` | 유저가 결제·로그인 취소 |

웹에서 자주 보는 서버 오류: `ORIGIN_NOT_ALLOWED`(허용 도메인 아님), `WEB_NOT_ENABLED`(웹 꺼짐). 전체 목록은 [오류 코드](/api/errors).
