본문으로 건너뛰기

저장소 (Storage)

앱 전용 영구 저장소에 데이터를 저장하고 조회하는 모듈입니다.

개요​

appify.storage는 AsyncStorage 기반의 키-값 저장소로, 브라우저의 localStorage보다 큰 용량을 지원합니다. 사용자 설정, 캐시 데이터, 인증 토큰 등 앱 실행 사이에 유지해야 하는 데이터를 저장할 때 사용합니다. 저장된 데이터는 앱이 삭제될 때 함께 삭제됩니다.

API​

getItem<T>(key: string): Promise<T | null>​

지정한 키에 저장된 값을 조회합니다.

매개변수

이름타입필수설명
keystring예조회할 데이터의 키

반환값: Promise<T | null> - 저장된 값, 존재하지 않으면 null

예제

import { appify } from '@nolraunsoft/appify-sdk';

const settings = await appify.storage.getItem<{ theme: string; fontSize: number }>('user_settings');
console.log(settings?.theme); // 'dark'

setItem(key: string, value: unknown): Promise<boolean>​

지정한 키에 값을 저장합니다. 객체와 배열을 포함한 모든 직렬화 가능한 값을 저장할 수 있습니다.

매개변수

이름타입필수설명
keystring예저장할 데이터의 키
valueunknown예저장할 값 (객체, 배열, 기본 타입 모두 가능)

반환값: Promise<boolean> - 저장 성공 여부

예제

import { appify } from '@nolraunsoft/appify-sdk';

const success = await appify.storage.setItem('user_settings', { theme: 'dark', fontSize: 16 });
console.log(success); // true

removeItem(key: string): Promise<boolean>​

지정한 키의 데이터를 삭제합니다.

매개변수

이름타입필수설명
keystring예삭제할 데이터의 키

반환값: Promise<boolean> - 삭제 성공 여부

예제

import { appify } from '@nolraunsoft/appify-sdk';

await appify.storage.removeItem('user_settings');

clear(): Promise<boolean>​

저장소의 모든 데이터를 삭제합니다.

매개변수

없음

반환값: Promise<boolean> - 삭제 성공 여부

예제

import { appify } from '@nolraunsoft/appify-sdk';

await appify.storage.clear();