화면 모드
오류 처리 (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(웹 꺼짐). 전체 목록은 오류 코드.