오류 처리
SDK가 던지는 오류는 EliceCDKError이고 code로 구분합니다. 예외는 init()이 fragment를 읽지 못했을 때의 AggregateError입니다(아래 참고).
import { EliceCDKError } from '@eliceio/cdk';
try {
await sdk.submit(answer);
} catch (err) {
if (err.code === EliceCDKError.code.ReadOnlyMode) {
// 튜터 화면: 제출 버튼을 숨김
}
}
- 코드 상수는
EliceCDKError.code.ReadOnlyMode처럼 씁니다. 값은 아래 표의 문자열입니다. cause에는 원래 오류가 들 어 있습니다. 서버가 요청을 거절했다면err.cause.cause에 서버 응답{ code, message, status, detail }이 있습니다.
init()의 AggregateError
fragment에 token · preview · edit 중 어느 것도 없거나, 토큰이 JWT 형식이 아니거나, versionId가 UUID가 아니면 init()은 AggregateError를 던집니다. errors 배열에 invalid_param 코드의 EliceCDKError가 문제마다 들어 있습니다.
try {
await sdk.init();
} catch (err) {
const errors = err instanceof AggregateError ? err.errors : [err];
console.error(errors.map(e => e.code));
}
init()이 실패하면 LXP가 실패 화면을 보여 주므로, 콘텐츠는 보통 로그만 남기면 됩니다.
오류 코드
| code | 언제 |
|---|---|
invalid_param | 주소에 토큰이나 자료 정보가 없음(init()은 AggregateError 안에), versionId가 그 자료의 저장된 버전이 아님, 또는 kvstore key 형식이 틀림 |
invalid_token | 토큰 내용(payload)을 읽을 수 없음 |
not_initialized | init() 전에 호출함 |
unauthorized | 토큰이 유효하지 않음. 학습자료를 다시 열면 새 토큰을 받음 |
session_expired | 새 토큰이 오기 전에 토큰이 만료됐거나 서버가 세션을 끝냄. 새로고침 안내 |
permission_denied | 토큰으로 할 수 없는 요청 |
read_only_mode | 튜터가 제출하거나 kvstore 값을 저장 · 삭제함 |
screen_not_supported | 이 화면에서 할 수 없는 요청(예: 설정 화면에서 submit, 학습 화면에서 saveSettings) |
draft_not_saved | 저장 전 업로드의 설정 화면(#edit=1)에서 saveSettings · assets.post. 자료를 먼저 저장 |
content_not_ready | 아직 저장된 버전이 없는 자료, 또는 draft가 처리 중 · 실패라 saveSettings를 거절함 |
invalid_input | 답이 64KB를 넘는 등 요청이 거절됨, 또는 kvstore key 경로 중간 값이 객체가 아님 |
rate_limited | 짧은 시간에 너무 많이 제출함(분당 30회), 또는 kvstore 저장 · 삭제가 너무 잦음(초당 20회) |
external_service_error | 서버가 AI 채점이나 점수 반영에 실패함. 제출은 저장되지 않았으니 다시 제출 |
navigation_timeout | 학습 페이지가 이전 · 다음 페이지 유무에 1초 안에 답하지 않음 |
file_invalid_type | assets.post에 PDF · PPTX · PNG · JPEG · WebP · GIF가 아닌 파일 |
file_invalid_size | assets.post에 0바이트이거나 한도(문서 95MB · 이미지 10MB)를 넘는 파일 |
script_load_failed | loadScript가 스크립트를 불러오지 못함 |
script_namespace_not_found | loadScript가 불러온 스크립트가 window[namespace]를 만들지 않음 |
storage_limit_exceeded | kvstore 저장으로 이 자료의 내 값이 512KB를 넘음 |
request_failed | 그 밖의 실패. 서버 코드는 err.cause.cause.code |
sdk.mlapi.fetch는 응답을 그대로 돌려주므로 서버 오류도 응답으로 옵니다. AI 호출을 봅니다.