결과 받는 법 | 공통 규칙 | Appbox SDK 가이드
결과 받는 법
기본 모양
| 상황 | 콜백 (err, data) | Promise |
|---|---|---|
| 성공 | err 는 null, data 에 결과(대개 data.result, data.message) | resolve { ack: true, ...data } |
| 앱이 실패를 돌려줌(권한 거부, 사용자가 닫음 등) | err.code, err.message | resolve { ack: false, error, code } (reject 하지 않음) |
| 앱 밖(일반 브라우저)에서 부름 | err.code 가 NOT_APPBOX | resolve { ack: false, error, code: "NOT_APPBOX" } (reject 하지 않음) |
| 넘긴 값이 형식에 맞지 않음 | err.code 가 VALIDATION | reject (err.code 가 VALIDATION) |
- 콜백의 data 에는 ack 가 없습니다. ack 는 Promise 결과에만 있습니다.
- 실패해도 Promise 가 reject 되지 않는 경우가 많습니다. await 결과의 ack 가 false 인지 꼭 확인하세요.
- 입력값 오류만 reject 됩니다. 그래서 try 와 ack 확인을 함께 써야 모든 실패를 잡을 수 있습니다.
입력값 오류를 바로 던지는 함수
| 함수 | 바로 던지는 경우 |
|---|---|
| gmenu.openTabsMenu | 메뉴 항목에 action 이 없음 |
| gmenu.openHamburgerMenu | 메뉴 항목에 text 나 action 이 없음 |
| gmenu.openBrowserMenu | 메뉴 항목의 function 이 허용 값이 아님 |
| gmenu.openFloatingMenu | 메뉴 항목의 icon 이 없거나 http(s) 주소가 아님 |
| ui.imageViewerOpen | item[].imageUrl 이 없거나 http(s) 주소가 아님 |
| message.subscribeToTopic, message.unsubscribeFromTopic | topicScheme 안에 빈 값 |
모양이 다른 함수
| 함수 | 결과 |
|---|---|
| AppboxSDK.getDeviceInfo() | { deviceUserId, pushToken, message }. ack 없음. 실패해도 오류가 없고 값이 빈 문자열 "" 입니다(앱 밖에서도 같음) |
| AppboxSDK.getDeviceUserId() | 성공 { result, message }(ack 없음), 실패 { ack: false, error, code: "NO_DEVICE_ID" } |
| AppboxSDK.journey.track() | { ok, status } 또는 { ok: false, error } |
| message.updateTopics() | 일부라도 실패하면 reject(UPDATE_TOPICS_PARTIAL, 상세는 err.result). 앱 밖에서 부르면 reject 하지 않고 { ack: false, code: "NOT_APPBOX" } |
| application.isAppBoxSDK() | true 또는 false 를 바로 돌려줌(Promise 아님) |
시간 제한
권장 코드
Javascript
1 async function callAppbox(run) {
2 try {
3 const res = await run();
4 if (res && res.ack === false) {
5 return { ok: false, code: res.code, message: res.error };
6 }
7 return { ok: true, data: res };
8 } catch (err) {
9 return { ok: false, code: err.code, message: err.message };
10 }
11 }
12
13 const r = await callAppbox(function () {
14 return AppboxSDK.application.getAppVersion();
15 });
16 if (r.ok) {
17 console.log("앱 버전", r.data.result);
18 } else {
19 console.warn("실패", r.code, r.message);
20 }