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 |
set | JSON.stringify 後存入 |
remove | 刪除一個 key(不存在也不會失敗) |
clear | 刪除這個小程序在這個帳號下的全部資料 |
| 規則 | 上限 |
|---|---|
| key | 1–128 字 |
| 單一 value(序列化後) | 1 MB(字串長度) |
| 總容量(所有 key 與 value 的 UTF-8 位元組) | 10 MB,超過以 QUOTA_EXCEEDED 失敗 |
- 隔離範圍:伺服器 × 帳號 × 小程序。
- 寫入約 0.3 秒後存檔;App 退到背景、關閉小程序時立即存檔。
set(key, undefined)會以INVALID_PARAMS失敗,請用remove。