본문으로 건너뛰기

오류 처리

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_initializedinit() 전에 호출함
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_typeassets.post에 PDF · PPTX · PNG · JPEG · WebP · GIF가 아닌 파일
file_invalid_sizeassets.post에 0바이트이거나 한도(문서 95MB · 이미지 10MB)를 넘는 파일
script_load_failedloadScript가 스크립트를 불러오지 못함
script_namespace_not_foundloadScript가 불러온 스크립트가 window[namespace]를 만들지 않음
storage_limit_exceededkvstore 저장으로 이 자료의 내 값이 512KB를 넘음
request_failed그 밖의 실패. 서버 코드는 err.cause.cause.code

sdk.mlapi.fetch는 응답을 그대로 돌려주므로 서버 오류도 응답으로 옵니다. AI 호출을 봅니다.