Skip to content

storage 儲存 ​

畫面層、邏輯層都可用(讀寫同一份資料)。需要容器 1.1.0。使用方式見資料儲存。

ts
sdk.storage.get<T = unknown>(key: string): Promise<T | null>
sdk.storage.set(key: string, value: unknown): Promise<void>
sdk.storage.remove(key: string): Promise<void>
sdk.storage.clear(): Promise<void>
方法說明
get讀取並 JSON.parse;不存在時回傳 null
setJSON.stringify 後存入
remove刪除一個 key(不存在也不會失敗)
clear刪除這個小程序在這個帳號下的全部資料
規則上限
key1–128 字
單一 value(序列化後)1 MB(字串長度)
總容量(所有 key 與 value 的 UTF-8 位元組)10 MB,超過以 QUOTA_EXCEEDED 失敗
  • 隔離範圍:伺服器 × 帳號 × 小程序。
  • 寫入約 0.3 秒後存檔;App 退到背景、關閉小程序時立即存檔。
  • set(key, undefined) 會以 INVALID_PARAMS 失敗,請用 remove。