Storage.setItems

기능 설명

모바일 앱의 로컬 저장소에 여러 문자열 값을 한 번에 저장해요. 앱이 종료되었다가 다시 시작해도 데이터가 유지돼요.

토스앱 Android/iOS 5.270.0 이상에서 사용할 수 있어요. 호출 전에 Storage.setItems.isSupported()로 지원 여부를 확인할 수 있어요. 미지원 버전에서 호출하면 UNSUPPORTED_APP_VERSION 에러가 발생해요.

타입

Storage.setItems(items: Record<string, string>): Promise<void>;

Params

type Items = Record<string, string>;

저장할 키와 문자열 값으로 구성된 객체예요.

Response

void

에러

코드	설명
UNSUPPORTED_APP_VERSION	실행 중인 토스앱 버전이 이 기능을 지원하지 않으면 호출 즉시 발생해요. Storage.setItems.isSupported()로 사전 확인하고, 발생 시 error.message를 사용자에게 보여주세요.

예시 코드

import { Storage } from "@apps-in-toss/web-framework";

if (Storage.setItems.isSupported()) {
  await Storage.setItems({
    theme: "dark",
    language: "ko",
  });
}